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PREFACE 


The purpose of this manual is to describe the capabilities of HP 3000 to HP 1000 communications using 
the Hewlett-Packard Distributed Systems Network, DSN/DS. These capabilities include using remote 
RTE commands to the HP 1000, using remote EXEC calls to the HP 1000, performing Remote File 
Access to files at the HP 1000, and perform Program-to-Program communications between the HP 3000 
and HP 1000. 


The capabilities that exist for HP 3000 to HP 1000 communications are a subset of the total capabilities 
available for HP 3000 to HP 3000 communications or HP 1000 to HP 1000 communications. That is, as 
an HP 3000 user, you will not be able to perform all of the functions available for HP 3000 to HP 3000 
communications. Likewise, not all functions available for HP 1000 to HP 1000 communications are 
possible for HP 3000 to HP 1000 communications. 


NOTE 


Most of the capabilities for HP 3000 to HP 1000 communications are 
programmatic. The interactive interface provides HP 1000 break mode 
commands only. 


This manual will describe HP 3000 to HP 1000 communications assuming that the user is knowledgeable 
about the basic operating principles of both the HP 3000 and HP 1000 or that an HP 3000 user and 
HP 1000 user are working together. 


The operating principles of the HP 3000 Series II/III/30/33/39/40/42/44/48/64 and 68 are described 
in the following manuals. 


e HP 3000 Computer Systems, MPE Commands Reference Manual (30000-90009) (MPE IV 

release); or 

HP 3000 Computer Systems, MPE V Commands Reference Manual (32033-90006); 

DSN/DS HP 3000 to HP 3000 User/Programmer Reference Manual (32189-90001); 

DSN/DS HP 3000 to HP 3000 Network Administrator Manual (32189-90002); 

Data Communications Handbook (30000-90105); 

HP 3000 Computer System, MPE Intrinsics Reference Manual (30000-90010) (MPE IV release); 

or 

HP 3000 Computer Systems, MPE V Intrinsics Reference Manual (32033-90007), 

e HP 3000 Computer System, System Manager/System Supervisor Reference Manual 
(30000-9001 4) (MPE IV release); 

e HP 3000 Computer System, Console Operator's Guide (32002-90004) (MPE IV release); 

e HP 3000 Computer Systems, MPE V System Operation and Resource Management Reference 
Manual (32033-90005). 
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NOTE 


The HP 3000 Computer System, MPE V System Operation and Resource 
Management Reference Manual listed above is the MPE V replacement for 
the System Manager/System Supervisor and Console Operator's Guide 
reference manuals. 


The HP 1000 user should refer to the following manuals for information on using DS/1000-IV: 


DS/1000-IV User's Manual (91750-90002); 

DS/1000-IV Network Manager's Manual, Vol. I and 11 (91750-90010 and 91750-9001 1); o— 
Getting Started With DS/1000-IV (91750-90004); 

DS/1000-IV Quick Reference Guide (91750-90005); 

Data Communications Handbook (30000-90105); 

RTE-IVB Programmer's Reference Manual (92068-90004); or 

RTE-6/VM Programmer's Reference Manual (92084-90005); or 

RTE-A Programmer's Reference Manual (92077-90007). 


NOTE 


For information about comunications between an HP 1000 and an HP 3000 
from the HP 1000, see the DS/1000-IV User's Manual. 
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NOTATION 


nonitalics 


italics 


[ ] 


{ } 


CONVENTIONS USED IN THIS MANUAL 


DESCRIPTION 


Words in syntax statements which are not in italics must be entered exactly as 
shown. Punctuation characters other than brackets, braces and ellipses must also be 
entered exactly as shown. For example: 


EXIT; 


Words in syntax statements which are in italics denote a parameter which must be 
replaced by a user-supplied variable. For example: 


CLOSE filename 


An element inside brackets in a syntax statement is optional. Several elements 
stacked inside brackets means the user may select any one or none of these elements. 
For example: 


A User may select A or B or neither. 


When several elements are stacked within braces in a syntax statement, the user must 
select one of those elements. For example: 


A 
B User must select A or B or C. 
C 


A horizontal ellipsis in a syntax statement indicates that a previous element may be 
repeated. For example: 


[,~temname]...; 


In addition, vertical and horizontal ellipses may be used in examples to indicate that 
portions of the example have been omitted. 


A shaded delimiter preceding a parameter in a syntax statement indicates that the 
delimiter must be supplied whenever (a) that parameter is included or (b) that 
parameter is omitted and any other parameter which follows is included. For 
example: 


itema[,ztemb] [,iteme] 


means that the following are allowed: 


itema 

itema,ttemb 
itema,itemb,iteme 
ttema,,iteme 
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underlining 


Prectivarstiiteiicrisayitsstittstti 
LU Seetiict itty 


PSS eer erter esses 
Sessrescesereuvodscotedtwesrels 


os 


CONTROL)cHar 


When necessary for clarity, the symbol A may be used in a syntax statement to 
indicate a required blank or an exact number of blanks. For example: 


SET [ (modifier) ]A(variable) ; 


When necessary for clarity in an example, user input may be underlined. For 
example: 


NEW NAME? ALPHA 


In addition, brackets, braces or ellipses appearing in syntax or format statements 
which must be entered as shown will be underlined. For example: 


LET var[[subseript]] = value 


Shading represents inverse video on the terminal’s screen. In addition, it is used to 
emphasize key portions of an example. 


The symbol (___) may be used to indicate a key on the terminal’s keyboard. For 
example, indicates the carriage return key. 


Control characters are indicated by followed by the character. For example, 
(CONTROL) Y means the user presses the control key and the character Y simultaneously. 
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SECTION 


SoH 


The Hewlett-Packard Distributed Systems Network (HP-DSN) is a combination of hardware and software 
products that make it possible for Hewlett-Packard computer systems to communicate with one another, 
and with IBM mainframes as well. The connections can be made over hardwired lines, and/or over the 
public telephone facility, and/or across Public Data Networks (PDNs), in any mixture. This capability, 
coupled with our proven remote entry capability to IBM computer systems, provides a total solution to 
large-company electronic data processing (EDP) needs. 


INTRODUCING DSN/DS 





Within the realm of HP-DSN is the software subsystem that accomplishes HP computer-to-HP computer 
communication over these connecting lines. This software subsystem is called DSN/Distributed Systems 
(DSN/DS). 


This manual describes how an HP 3000 user can communicate with an HP 1000 computer by establishing 
a communications link using DSN/DS. Since each of these computers perform functionally different data 
processing tasks, their association in a network provides you with the benefits of their combined 
capabilities. 


Once the communications link is established, DSN/DS allows you to: 


e Use remote RTE operator commands to the HP 1000 System. The RTE operator commands 
are executed in the remote HP 1000 but the output resulting from the executed commands 
will appear at your log-on terminal at the HP 3000 end. This is described in Section 3. 


e Use remote EXEC calls to the HP 1000 System. Remote EXEC calls allow you to interface 
with remote I/O devices programmatically. This is described in Section 4. 


e Perform Remote File Access to files in the HP 1000 System, using RFA _intrinsics 
programmatically. This capability permits you to access any of the disc files residing at the 
remote HP 1000 as though they reside at your local HP 3000 site. This is described in Section 
5. 


e Perform Program-to-Program Communication between the HP 3000 and HP 1000 system, 
using Program-to-Program (PTOP) intrinsics. This capability permits programs residing in 
different HP computer systems to interactively exchange information with one another in a 
coordinated manner. This is described in Section 6. 


But what exactly does this overall capability mean? It means that a large multidivisional corporation can 
have a truly coordinated world-wide network of computer systems. They are coordinated in the sense of 
tying together the various commercial and industrial functions within each division and factory, and they 
are also coordinated in the larger sense of tying together the various divisions and factories at the 
corporate level. 


For example, imagine a large corporation which has factories in the United States, Canada, France, and 
West Germany. Within each factory there are HP 1000 computer systems performing such functions as 
inventory control, factory data collection, and operations management. With a Hewlett-Packard 
Distributed Systems Network these manufacturing information systems can be tied into an HP 3000 
system which handles the factory’s administrative functions (such as finance and accounting). The 
administrative systems of each factory can, in turn, be connected not only to one another but also to a 
mainframe computer (via DSN/RJE, DSN/MRJE, or DSN/SNA NRJE) at corporate headquarters. This 
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overall networking capability makes it possible to perform financial analysis and control at a group and 
corporate level as well as at the individual factories. 


The following summarizes the four ways you can use DS/3000 to communicate with HP 1000 systems: 


REMOTE 
OPERATOR 
COMMANDS 


REMOTE 
EXEC 
CALLS 


REMOTE 
FILE 
ACCESS 


PROGRAM 
TO 
PROGRAM 
COMMUNI- 
CATION 


HP 3000 


From a terminal, issue a remote 
command. 


Write and execute an _ SPL, 
FORTRAN, PASCAL, or COBOL/II 
program using remote EXEC calls. 


Write and execute an _ SPL, 
FORTRAN, PASCAL, or COBOL/II 
program using Remote File Access 
(RFA) intrinsics. 


Write and execute a master or slave 
program in SPL, FORTRAN, 
PASCAL, COBOL, COBOL/II, or 
BASIC using Program-to-Program 
intrinsics. 


HP 1000 


Execute an operator command. 


Execute an EXEC call. 


Access a disc file. 


Write and execute a master or slave 
program in FORTRAN, PASCAL, 
or assembly language using 
Program~-to-Program intrinsics. 


In Program-to-Program (PTOP) communications, the programs can reside on either system: 





HP 3000 HP 1000 
Master Program —————————~> Slave Program 


or 


Slave Program «<—————_—————- Master Program 
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As a simplified example of a computer network, imagine that you are in the same room with an HP 3000 
(labeled "System A" in Figure 1-1) and that an HP 1000 (labeled "System B") resides in another part of the 
building. These two computers are connected to one another by a cable and a pair of communications 
interfaces. With DSN/DS you can use the processing capability of both the HP 3000 and the HP 1000 
and pass data back and forth between them by entering commands through a single terminal. 


To see how DSN/DS works in this simple example, read through the step-by-step procedure which 
follows. 


HP3000 Communications HP 1000 
SYSTEM A Interface SYSTEM B 
Interconnecting 
Cable 


Figure 1-1. HP 3000 to HP 1000 Example 
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Step 1. Sit down at a terminal connected to System A and initiate a session. 





RETURN 
sHELLO USER. ACCOUNT 


HP3000 / MPE IV C.00.04. WED, MAR 3, 1982, 9:05 AM 


WELCOME TO SYSTEM A. 


® 
e 


Within the context of DSN/DS, such a session is referred to as a local session because it is active within 
the HP 3000 to which your terminal is directly connected. This terminology becomes more meaningful 
later, since all you have actually done, so far, is initiate a standard MPE session. At this point, you have 
reached the situation illustrated in Figure 1-2. 





HP3000 Communications HP1000 
SYSTEM A Interface SYSTEM B 





Interconnecting 
Cable 





Figure 1-2. Initiating the Local] Session 
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Step 2. Now, open a communications line between System A and System B. Do this by entering a 
c 4 :DSLINE command. 


:DSLINE RSYS1000 


DS LINE NUMBER = #L3 


In this example, RSYS1000 is the device class name for the particular line established during system 
configuration (in System A) you wish to use. DSN/DS opens the line and then assigns you a line number 
(3 in this example). This line number is analogous to the file number returned to you by the MPE File 
System when you open a file programmatically using the FOPEN intrinsic. Within your local session, it 
uniquely identifies the particular line that you have opened. This becomes significant only if you must 
open more than one communications line during a Session. 


Step 3. Now that you have acquired access to a communications line between System A and System B, 
you may execute remote RTE operator commands. Do this by entering a REMOTE command which 
includes an RTE operator command for the remote system. For example, use the TI command 
(RTE-6/VM) to determine the remote HP 1000 system time. 





:REMOTE TI 


1983 249 8 39 3 


Step 4. Now determine the time from the local HP 3000 using the MPE SHOWTIME command. 
: SHOWTIME 


TUE, SEP 6, 1983, 8:40AM 


Notice that in Steps 3 and 4 it 1s the presence or absence of the REMOTE prefix which determines whether 
a command is to be executed on the local system or on the remote system. 


1-5 


Introducing DSN/DS 
Step 5. Suppose you wish to use the line printer on the HP 1000. This time, instead of having to use the 
REMOTE prefix for each command, try a different technique. Enter the following: 


:REMOTE 
# 


This command gives you access to the remote system in such a way that all commands which follow can 


be entered in their normal form (without the prefix REMOTE). The # is the prompt character issued by 
DSN/DS (in place of the usual MPE colon prompt). 


Step 6. Now determine the status of the remote line printer. If the line printer is down, enable it. 
#EQ,6 
36 DV.12 0 BU O 1 
#UP ,6 
#EQ,6 
36 DV.12 0 BUO0O 


# 


Step 7. The work in System B is now completed so return control to your local session by typing a colon. 


#: 


Note that you are now back in the local session in System A (signified by the colon prompt). To close the 
communications line, enter the following variation of the :DSLINE command: 


:DSLINE RSYS1000;CLOSE 


1 DS LINE WAS CLOSED. 


Finally, terminate the local session. 


>BYE 


CPU=1. CONNECT=11. TUE, SEP 6, 1983, 9:16 AM 
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SECTION 


THE COMMUNICATIONS LINK 








As an HP 3000 user you need only issue a :DSLINE user command from your terminal to establish a link 
with an HP 1000 system. 


However, before you can issue this command successfully, the hardware connections must be made, and 
the DS/3000 and DS/1000-IV software enabled. To do this: 


e The HP customer engineer installs the hardware connection between the systems. 


e The HP 1000 network manager generates a DS/1000-IV network and runs the program DINIT 
(and DSLIN if necessary). Instructions are provided in the Network Manager's manuals. 


© The HP 3000 system supervisor configures the HP 3000 system to include DSN/DS 3000. 
Instructions are provided in the System Manager/System Supervisor Manual. 





e The HP 3000 system operator initiates the : DSCONTROL command to enable the DS subsystem on 
the communications link. Instructions are provided in Appendix B of this manual. 


Now you can log on to a terminal and issue the :DSLINE user command to establish communications with 
the HP 1000 system. (See Figure 2-1.) 





NOTE 


The term session is used rather loosely in this section to differentiate 
between work done on the local system and work done on the remote 
system (as in local session and remote session). It is not always possible to 
establish a remote session with the HP 1000 in the literal sense. A literal 
definition of session appears later in this section during a brief discussion of 
Session Access versus Non-~session Access. 
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Figure 2-1. DSN/DS Communications Link (HP 3000 to HP 1000) 


OPENING A LINE 


A communications link can be established over a hardwired communications line, over the public 
telephone network, or over an X.25 Public Data Network (PDN). The procedures for opening hardwired 
lines and for opening telephone lines differ only slightly. Much of the discussion which follows for 
Opening a Hardwired Line and Opening a Telephone Line is identical. The information is repeated for 
each topic so that you need only read that which is appropriate for your situation. Generally, once the 
connection to the remote computer is established, you will perceive no difference in the way DSN/DS 
performs. 


Opening a Hardwired Line 


What is a hardwired line? In the general field of data communications there are two types of lines 
commonly referred to as hardwired. The first type is a dedicated path on the public telephone network 
that 1s leased from the telephone company for the private use of a computer-to-computer configuration. 
Such a line serves as a permanent connection between the two computers. The other type of hardwired 
line is a cable that is connected directly to the communications I/O interfaces of the two computers. 
Within the context of DSN/DS, hardwired always refers to the latter. However, the technique used for 
opening a line is the same for either a direct-connect line or a leased (nonswitched) telephone line. 


The hardwired interconnecting cable connects to each computer by way of a communications interface. 
For a hardwire connection, there are two options available: the Hardwired Serial Interface (HSI), or the 
Intelligent Network Processor (INP) to Programmable Serial Interface (PSI). 


The Hardwired Serial Interface (HSI) connection consists of the HP 30360A HSI interface card for the 
HP 3000 Series II and III (Series 30/33/40/44 and 64 do not support the HSI), and the HP 12889A HSI 
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card for the HP 1000. Each HSI card occupies one card slot in the Multiplexor channel of the HP 3000 
and can accomodate up to four connections to HP 1000s. Only one of the four lines can be used at any 
given time and the HP 3000 console operator has control over which line is active. The HP 3000 Series II 
and III can accomodate a maximum of 2 HSI cards. 


The Intelligent Network Processor (INP) to Programmable Serial Interface (PSI) connection utilizes 
microprocessor-based interface cards in both the HP 3000 and HP 1000, and offloads the task of DS 
transmission management from the CPU to the card. The connection is established by using the 
HP 30010A INP in the HP 3000 Series II and HI or the HP 30020B INP in the HP 3000 Series 
30/33/39/40/42/44/48/64 and 68 Computer Systems. On the HP 1000 side, an HP 12834A PSI card is 
used in the HP1000 M, E, and F Series and an HP 12082A PSI card 1s used in the HP 1000 A Series. The 
maximum distance allowed when using this connection 1s one kilometer. 


The hardwire connections are summarized in Table 2-1. 


Table 2-1. Associations between Controllers and Systems (hardwired line) 


HP 3000 Series II and III HP 30360A HSI card 
HP 30010A INP card 

HP 3000 Series 30/33/39/40/42/44/48/64/68 HP 30020B INP card 
HP 1000 M, E, and F Series HP 12889A HSI card 
HP 12834A PSI card 
HP 1000 A Series HP 12889A HSI card 
HP 12082A PSI card 
For most applications, the INP to PSI connection offers a much better method of HP 3000 to HP 1000 
communication. The HSI cards impose substantial overhead on the CPU’s (both 3000 and 1000) due to 
the combination of a fast transfer rate (2.5 megabits/sec) and a small interface buffer size (1 word). The 
INP to PSI connection operates at up to 56 kilobits/sec, but offers 1024 words of buffering on the INP 


and 1072 words of buffering on the PSI. The microprocessors on each card handle the communications 
protocol and handshaking, thus freeing the CPU for more important tasks. 







It is relatively straightforward to obtain access to a hardwired communications line. All you are required 
to do is identify the particular communications interface you wish to use. You do this by specifying the 
device class name or logical device number associated during system configuration with the desired 
interface. In the example in Section 1, the :DSLINE command was used for this purpose, as follows: 


:DSLINE RSYS1000 


In the :DSLINE command you may also wish to specify the size of the DSN/DS line buffer to be used in 
conjunction with the line. The size of this buffer determines the maximum amount of data that can be 
sent or received in a single physical transmission over the line. Note that a transmission as you normally 
think of it (sending or receiving all or part of a file) may actually consist of many physical transmissions. 
In essence, this buffer size defines a blocking factor for the line. (See Figure 2-2.) A default buffer size 
is established during system configuration, and in most cases (as in the example in Section 1), you will find 


it satisfactory to let this default value prevail. Linebuffering is the same for both hardwired and 
telephone lines. 
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Figure 2-2, DSN/DS Line Buffer Example 


1200 words of data to be 
transmitted 


First physical transmission: 
512 words (492 words of data 
+ 20 words of DS overhead) 


Second physical transmission: 
512 words (492 words of data 
+ 20 words of DS overhead) 


Third physical transmission: 
236 words (216 words of data 
+ 20 words of DS overhead) 


1200 words of data received 
at remote computer 
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When you execute a :DSLINE command, DSN/DS attempts to give you access to the specified 
communications line and, if successful, informs you of the assigned DS line number by displaying the 
following message at your terminal: 


DS LINE NUMBER = #Lx 


where x is the assigned DS line number. In the example in Section 1, the DS line number 3 was assigned. 
The DS line number is significant only if you open and use more than one communications line 
concurrently within a single local session (see "Opening Multiple Lines" later in this section). 


Now that you have established the physical communications line via the :DSLINE command, you will be 
able to communicate with the remote HP 1000. With RTE-6/VM running on the HP 1000 M, E, and F 
Series, two possibilities exist depending on how the HP 1000 was GEN’d. The two possibilities are session 
access and non-session access. If the HP 1000 is an A Series running RTE-A, only non-session access is 
available. 


SESSION ACCESS. Session access allows you to log on to the remote HP 1000 using either the REMOTE 
HELLO RUSER.RGROUP format or by issuing the REMOTE command and typing HELLO RUSER.RGROUP in 
response to the remote prompt (#). Session access allows you to access those files available for the 
RUSER.RGROUP session you have established. It is also possible to allow the DSN/DS 1000-IV software to 
establish a remote session for you by simply typing REMOTE and the RTE operator command. In this case, 
you will be logged on to a default session on the remote HP 1000. This allows you access to only those 
files assigned to the default session. See the DS/1000-IV User's Manual for details. 


NON-SESSION ACCESS. If the HP 1000 M, E, or F Series was GEN’d for non-session access or if the 
HP 1000 computer is an A Series, it is not possible to establish a session with a set of files belonging to a 
particular group, that is, a REMOTE HELLO is not possible. Once you have established the DS line, you 
have access to all the system files by simply typing the REMOTE command followed by the HP 1000 
command. RTE-A running on the HP 1000 A Series only supports non-session access. 


Opening a Telephone Line 


A DSN/DS communications link can also be established over the public (dial-up) telephone network. In 
such a case, the information passed back and forth between the two computers travels over the same lines 
that are used for normal voice traffic. Each computer is interfaced to the telephone lines by way of a 
modem. (The term modem is a contraction of MOdulator-DEModulator.) A modem is a device that 
translates digital signals (electrical impulses) generated by a computer into analog signals (tones) that can 
be transmitted over telephone lines, and vice versa. 


The modem connects to the HP 3000 or the HP 1000 through the use of a communications interface. For 
the HP 3000 Series II and III, an HP 30055A SSLC card or an HP 30010A INP interface may be used. 
For the HP 3000 Series 30, 33, 39, 40, 42, 44, 48, 64, or 68, an HP 30020B INP interface is used. The 
HP 12793A BISYNC MODEM PSI card is used in the HP 1000 M, E, and F Series and the HP 12073A 
BYSYNC MODEM PSI card is used in the HP 1000 A Series. Refer to Table 2-2 for a summary of the 
hardware requirements for an HP 3000 to HP 1000 modem connection. 
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Table 2-2. Associations between Systems and Controllers (telephone line) 


HP 30010A INP card 


It is a little more complex to obtain access to a telephone line than to a hardwired line. First, you must 
identify the particular communications interface (INP or SSLC) you wish to use. You do this by 
specifying the device class name or logical device number of the communication line that was associated 
during system configuration with the desired interface. You can use the :DSLINE command for this 
purpose, as follows: 










:DSLINE RSYS1000 


In the ;:DSLINE command, you may also wish to specify the size of the DSN/DS line buffer to be used in 
conjunction with the line. The size of this buffer determines the maximum sized block that can be sent 
or received in a single physical transmission over the line. Note that a transmission as you normally think 
of it (sending or receiving all or part of a file) may actually consist of many physical transmissions. In 
essence, this buffer size defines a blocking factor for the line. (See Figure 2-2.) A default buffer size is 
established during system configuration, and in most cases (as in the example in Section 1), you will find it 
satisfactory to let this default value prevail. Linebuffering is the same for both hardwired and telephone 
lines. 


Next, you may wish to supply a set of identification (ID) sequences to be used in verifying that the desired 
pair of computers are connected to one another. This is discussed under "ID Sequences" later in this 
section. Briefly, however, you may supply an ID sequence that identifies your HP 3000 and one or more 
ID sequences that identify those remote computers with which your HP 3000 may validly be connected. 
When a telephone connection is established between your HP 3000 and a remote HP 1000, the two 
computers exchange ID sequences and their validity determines whether or not the connection is to 
remain in effect. You use the :DSLINE command to supply ID sequences, as follows: 


:DSLINE RSYS1000 ;LOCID="SYSTEM A’ & 
sREMID="SYSTEM X" 


where SYSTEM A is the ID sequence identifying your HP 3000 and SYSTEM X is the ID sequence 
identifying the remote computer with which you want to establish a telephone connection. 


Again, there are default values that can be established during system configuration. In most cases, 
however, you will at least want to explicitly identify the desired remote HP 1000 to be certain that the 
proper connection is being established. 


Now you must establish the physical connection between the two computers by dialing (at the modem) the 
telephone number of the remote computer and responding (at the system console) to the dial request. If 
you wish to have the console operator of your HP 3000 dial the number for you, you may supply the 
desired number in the :DSLINE command and it will be displayed as part of a dial request message at the 
operator’s console. In this case, you would supply the telephone number as follows: 
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:DSLINE RSYS1000 ;LOCID="SYSTEM A" & 
s;REMID="SYSTEM X" & 
; PHNUM=555- 1234 


If autodial equipment is installed on the RSYS1000 line, the telephone number supplied in the :DSLINE 
command is used instead of the number configured for the line. If a phone number is not supplied in the 
: DSLINE command, the configured number will be dialed. 


The various possibilities involved in establishing a telephone connection with a remote computer are 
discussed under "Dialing the Remote Computer" later in this section. 


When you execute the :DSLINE command, DSN/DS attempts to give you access to the specified 
communications interface (INP or SSLC) and, if the telephone connection is successfully established, 
informs you of the assigned DS line number by displaying the following message at your terminal: 


DS LINE NUMBER = #Lx 


where x is the assigned DS line number. In the example in Section 1, the DS line number 3 was assigned. 
The DS line number is significant only if you open and use more than one communications line 
concurrently within a single local session (see "Opening Multiple Lines" later in this section). 


Now that you have established the physical communications line via the :DSLINE command, you will be 
able to communicate with the remote HP 1000. With RTE-6/VM running on the HP 1000M, E, and F 
Series, two possibilities exist depending on how the HP 1000 was GEN’d. The two possibilities are session 
access and non-session access. If the HP 1000 is an A Series running RTE-A, only non-session access is 
available. 


SESSION ACCESS, Session access allows you to log on to the remote HP 1000 using either the REMOTE 
HELLO RUSER.RGROUP format or by issuing the REMOTE command and typing HELLO RUSER.RGROUP in 
response to the remote prompt (#). Session access allows you to access those files available for the 
RUSER.RGROUP session you have established. It is also possible to allow the DSN/DS 1000-IV software to 
establish a remote session for you by simply typing REMOTE and the RTE operator command. In this case, 
you will be logged on to a default session on the remote HP 1000. This allows you access to only those 
files assigned to the default session. See the DS/1000-IV User's Manual for details. 


NON-SESSION ACCESS. If the HP 1000 computer M, E, or F Series was GEN’d for non-session access or 
if the HP 1000 is an A Series, it is not possible to establish a session with a set of files belonging to a 
particular group, that is,a REMOTE HELLO is not possible. Once you have established the DS line, you 
have access to all the system files by simply typing the REMOTE command followed by the HP 1000 
command. RTE-A running on the HP 1000 A Series only supports non-session access. 


Specifying a Line 


As you have seen, in order to open either a hardwired communications line or a dial-up telephone line, 
you must specify a device class name or logical device number identifying the particular communication 
line that is associated with a specific INP, HSI, or SSLC that you wish to use. But how do you figure out 
which name or number to specify? The discussion of this topic may seem a little complex and tedious, 
particularly at first reading. In actual practice, however, once the hardware and software configuration is 
installed and usable, most DSN/DS sites will post a notice defining all of the available communications 
lines and the proper device class names and logical device numbers for each. In that case, all of the 
detective work described in the following paragraphs is already done for you. 
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For each communications interface, there is a pair of associated drivers. First, there is the actual INP, 
HSI, or SSLC driver that directly controls the operation of the interface board. In addition, there is a 
DSN/DS communications driver that controls the operation of the INP, HSI, or SSLC driver. The names 
of these drivers are as follows: 


IOINPO (INP driver) 

CSHBSCO (HSI driver) 

CSSBSCO_ —— (SSLC driver) 

IODSO (DSN/DS communications driver, while utilizing the bisync protocol) 
IODSX (DSN/DS communications driver, while utilizing the X.25 capability) 


If you have only one communications interface (INP, HSI, or SSLC) configured into your system, there is 
no question about which name or number to specify in a :DSLINE command. If there is more than one 
communications interface, however, you must know (or ask someone who knows) which CSHBSCOQO, 
CSSBSCO, or IOINPO pertains to the physical line you want to use. 


One or more virtual terminal drivers (IODSTRMO or IODSTRMxX) should also be configured into the 
system. The IODSTRMO or IODSTRMxX entries allow users on another system to be logged on to this 
system and regulate the number of remote Session Main Processes (SMP) that can be assigned to a given 
line. Each IODSTRMO or IODSTRMX entry is related to the proper communications interface entry by 
the number specified in the column labeled DRT. Figure 2-3 shows logical devices 60 through 64 are 
paired with logical device 12; Figure 2-4 shows logical device 69 paired with logical device 27; Figure 
2-5 shows logical device 71 paired with logical device 29; and Figure 2-6 shows logical device 68 paired 
with logical device 26. 


Now look at the appropriate sample I/O device table produced during system configuration (See Figure 
2-3 and 2-4 for a hardwired line or Figure 2-5 and 2-6 for a telephone line). 


In Figure 2-3, notice that the HSI board entries (logical devices 12 through 15) look the same except for 
the PORTMASK. The PORTMASK specifies which port on the board is to be used. There are also virtual 
terminals (logical devices 60 through 64) referencing back to logical device 12. Since only one port on the 
HSI board can be opened at a time, only one block of virtual terminal entries is needed for that board. As 
each port is opened individually by specifying the corresponding dsdevice in the :DSCONTROL command 
(see Appendix B), the system automatically reallocates the block of virtual terminal entries to the proper 
HSI board entry. This reallocation will not, however, show up in the I/O configuration table. 


In Figure 2-3, the shaded items in the column labeled DRIVER NAME show four HSI lines (CSHBSCO) 
configured into the system as logical devices 12 through 15. For each one of these lines, there is a 
DSN/DS communications driver, IODSO, also configured into the system. Each IODSO entry is related to 
the proper HSI entry by the number specified in the column labeled DRT (the # prefix indicates a back 
reference to a previously defined logical device number). Logical devices 50 through 53 are paired with 
logical devices 12 through 15, respectively. In this example, it is the device class name or logical device 
number of the appropriate IODSO entry that would be used to specify the desired line. 
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LOG DRT U CT SUB REC OUTPUT MODE DRIVER DEVICE 
DEV # N HY TYPE TERMINAL WIDTH DEV NAME CLASSES 
# I AP TYPE SPEED 
T NE 
1 4 000 6 128 0 IOMDISC1 SPOOL 
SYSDISK 
2 000 3 128 0 IOMDISCO DISC 
5 008 0 40 LP JA S$ IOCRDO CARD 
6 0 0 322 66 0 S IOPRTO LP 
7 0 0240 128 LP IOTAPEO TAPE 
8 1 0240 128 LP IOTAPEO TAPE 
9 2 0240 128 LP IOTAPEO TAPE 
1 3 0240 128 LP JA S IOTAPEO  BATAPE 
1 0 0 340 128 0 IOPTPNO PTPUNCH 
4 0 019 3 0 0 af ) HSI 
0 0193 0 0 HSI2 
0 019 3 9) 8) HSI3 
4 0 019 3 0 0 CSHBSCG HSI4 
0 0160 10 ?? 40 20 JAID IOTERMO CONSOLE 
10160 11 «?? 40 21 JAID IOTERMO TERM 
2 0160 11 =?? 40 22 JAID IOTERMO TERM 
3 0160 11 =?? 40 23 JAID IOTERMO TERM 
4 0160 11 ?? 40 24 JAID IOTERMO TERM 
5 0161 11 2? 40 25 JAID IOTERMO TERM 
0 0170 0 0 IOINPO INP1 
00173 0 0 IOINPO INP2 
0 0180 0 0 CSSBSCO SSLC2 
0 0410 128 0) TODS! HDS 1 
0 0 410 128 0 HDS2 
0 O 410 128 fe) HDS3 
0 0 410 128 0 HDS4 
00168 ?? ?? 40 60 J ID DSTERM 
00168 ?? ?? 40 61 J ID DSTERM 
00168 ?? ?? 40 62 J ID DSTERM 
00168 ?2? ?? 40 63 J ID DSTERM 
0 0168 ?? ?? 40 64 J ID DSTERM 
66 #26 0 O 41 1 128 0 DSLINE1 
67 #27 0 O 41 1 128 0 DSLINE2 
68 #26 0 0168 ?? ?? 40 68 J ID IODSTRMO INP! 
69 #27 0 0168 ?2 ?? 40 69 J ID IODSTRMO INP2 
70 #29 0 O 410 7? 128 O IODSO SDS 1 
71 #29 0 0168 ?? «?? 36 71 J ID  IODSTRMO DSTERM 


Figure 2-3, Sample I/O Device Table (Hardwired Line with HSI) 
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In Figure 2-4, the shaded items in the column labeled DRIVER NAME show an INP (IOINPO) configured 
into the system as logical device 27. (Note that the subtype is 3, indicating hardwired.) For this line, 
there is a DSN/DS communications driver (IODSO) also configured into the system. The IODSO entry is 
related to the proper INP entry by the number specified in the column labeled DRT (the # prefix indicates 
a back reference to a previously defined logical device number). Logical device 67 is paired with logical 
device 27. In this example, it is the device class name (DSLINE2) or logical device number (67) of the 
IODSO entry that would be used to specify the desired line. 


NOTE 


Figure 2-4 does not show a line configured for X.25 activity to an 
HP 1000. The back referencing scheme is identical to this example. 
However, the following differences should be noted for an X.25 
configuration: 


e The communications driver is named [ODSX. 


e The device class name or logical device number of an IODSX entry should 
not be used in a :DSLINE command (or in other commands, such as 
DSCOPY). To access the desired remote node, we encourage DSN/X. 25 
users to enter a nodename whenever a dsdevice is required. See 
"Specifying an X.25 Line" later in this section. 
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LOG DRT U CT SUB REC OUTPUT MODE DRIVER DEVICE 
DEV # N HY TYPE TERMINAL WIDTH DEV NAME CLASSES 
# I AP TYPE SPEED 
TONE 
1 4 000 6 128 0 IOMDISC1 SPOOL 
| SYSDISK 
000 3 128 0 IOMDISCO DISC 
008 0 40 LP JA § IOCRDO CARD 
0 0322 66 0 IOPRTO ~—s LP 
0 0240 128 LP IOTAPEO TAPE 
1 0240 128 LP IOTAPEO TAPE 
2 0240 128 LP IOTAPEO TAPE 
3 0 240 128 LP JA IOTAPEO BATAPE 
0 0340 128 0 IOPTPNO = PTPUNCH 
0 0193 0 0 CSHBSCO ——-HST1 
0 0193 0 0 CSHBSCO -HSI2 
0 0193 0 ) CSHBSCO —-HSI3 
0 0193 0 0 CSHBSCO —-HSI4 
0 0160 10 2? 40 20 JAID IOTERMO CONSOLE 
10160 11 2? 40 21 JAID IOTERMO TERM 
20160 11 2 40 22 JAID IOTERMO TERM 
3 0160 11 2 40 23 JAID IOTERMO TERM 
4 0160 11 2? 40 24 JAID IOTERMO TERM 
5 0161 11 2? 40 25 JAID IOTERMO TERM 
0 0170 0 ) IOINPO —sINP'1 
0 0178 0 0 TOINPS INP2 
0 0180 0 0 CSSBSCO = SSLC2 
0 0 410 128 0 IODSO HDS 1 
0 0410 128 0 IODSO HDS2 
0 0 410 128 80 IODSO HDS3 
0 0410 128 0 IODSO HDS4 
0 0168 ?? 2 40 60 J ID IODSTRMO DSTERM 
0 0168 ?2? 2 40 61 J ID  IODSTRMO DSTERM 
0 0168 ?? 2 40 62 J ID  IODSTRMO DSTERM 
0 0168 72 2 40 63 J ID  IODSTRMO DSTERM 
0 0168 ?? 2 40 64 J ID IODSTRMO DSTERM 
0 0168 ?? 2 40 65 J ID IODSTRMO DSTERM 
0 041 1 128 0 IODSO DSLINE1 
0 041 1 128 8600 TODS DSLINE2 
0 0168 ?? 2 40 68 J ID  IODSTRMO  INP1 
0 0168 ?? 2 40 69 JID YODSTRHG INP2 
0 0410 2? 128 0 IODSO SDS 1 
0 0168 ?? 2 36 71 J ID  IODSTRMO DSTERM 





Figure 2-4. Sample I/O Device Table (Hardwired Line with INP) 
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In Figure 2-5, the shaded items in the column labeled DRIVER NAME show one SSLC (CSSBSCO) 
configured into the system as logical device 29. (Note that the subtype is 0, indicating a switched 
telephone line.) Notice the DSN/DS communications driver, IODSO, is related to the SSLC entry by the 
number specified in the column labeled DRT (the # prefix indicates a back reference to a previously 
defined logical device number). Logical device 70 is paired with logical device 29. It is the device class 
name (SDS1) or logical device number (70) of the IODSO entry that would be used to specify the desired 
line. 
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CT SUB REC OUTPUT 
H Y TYPE TERMINAL WIDTH DEV 
AP TYPE SPEED 

NE 

00 6 128 0 
00 3 128 0 
08 0 40 LP 

0 32 2 66 0 
0 240 128 LP 

0 240 128 LP 

0 240 128 LP 

0 24 0 128 LP 

0 340 128 0 
0193 0 0 
019 3 0 0 
0193 0 0 
0193 0 0 
0160 10 2 40 20 
0160 11 2? 40 21 
0160 1 2? 40 22 
0160 11 2 40 23 
0160 11 2 40 24 
0161 11 2? 40 25 
0170 0 0 
0173 0 0 
0186 0 0 
0 41 0 128 0 
0 41 0 128 0 
0 410 128 0 
0 41 0 128 0 
0168 ?? 2 40 60 
0168 ?? 2 40 61 
0168 ?? 2? 40 62 
0168 7? 2? 40 63 
0168 ?? 2 40 64 
0168 ?? 2? 40 65 
041 1 128 0 
041 1 128 0 
0168 ?? 2? 40 68 
0168 ?? 2? 40 69 
0 410 2? 128 0 
0168 ?? ?? 36 71 


Figure 2-5, 
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DRIVER 
NAME 


IOMDISC1 


TOMDISCO 
IOCRDO 
TOPRTO 
IOTAPEO 
IOTAPEO 
TOTAPEO 
IOTAPEO 
IOPTPNO 
CSHBSCO 
CSHBSCO 
CSHBSCO 
CSHBSCO 
IOTERMO 
IOTERMO 
IOTERMO 
IOTERMO 
IOTERMO 
IOTERMO 





IODSTRMO 
IODSTRMO 
IODSTRMO 
ITODSTRMO 
ITODSTRMO 
IODSTRMO 
IODSO 

TODSO 

TODSTRMO 


TODSTRMO 





Sample I/O Device Table (Telephone Line with SSLC) 


DEVICE 
CLASSES 


SPOOL 
SYSDISK 
DISC 
CARD 

LP 
TAPE 
TAPE 
TAPE 
BATAPE 
PTPUNCH 
HST 1 
HST2 
HSI3 
HST4 
CONSOLE 
TERM 
TERM 
TERM 
TERM 
TERM 
INP1 
INP2 
SSLC2 
HDS 1 
HDS2 
HDS3 
HDS4 
DSTERM 
DSTERM 
DSTERM 
DSTERM 
DSTERM 
DSTERM 
DSLINE1 
DSLINE2 
INP1 
INP2 
SDS 1 
DSTERM 
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In Figure 2-6, the shaded items in the column labeled DRIVER NAME show an INP (IOINPO) configured 
into the system as logical device 26. (Note that the subtype is 0. This indicates that the INP is used fora 
dial-up line.) For this line, there is a DSN/DS communications driver, IODSO, also configured into the 
system. The IODSO entry is related to the proper INP entry by the number specified in the column 
labeled DRT (the # prefix indicates a back reference to a previously defined logical device number). 
Logical device 66 is paired with logical device 26. It is the device class name (DSLINE1) or logical device 
number (66) of the IODSO entry that would be used to specify the desired line. 
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LOG DRT U CT SUB REC OUTPUT MODE DRIVER DEVICE 
DEV # N HY TYPE TERMINAL WIDTH DEV NAME CLASSES 
# I AP TYPE SPEED 
TNE 
1 4 000 6 128 0 IOMDISC1 SPOOL 
SYSDISK 
000 3 128 0 IOMDISCO DISC 
0 08 0 40 LP JA $ IOCRDO CARD 
0 0 322 66 ) S IOPRTO LP 
0 0240 128 LP IOTAPEO TAPE 
1 0240 128 LP IOTAPEO TAPE 
2 0240 128 LP IOTAPEO TAPE 
3 0 240 128 LP JA IOTAPEO —BATAPE 
0 0340 128 0 IOPTPNO PTPUNCH 
0 0193 0 ) CSHBSCO —HSI1 
0 0193 0 0 CSHBSCO —HSI2 
00193 0 ) CSHBSCO —HSI3 
00193 0 0 CSHBSCO —HSI4 
00160 10 2? 40 20 JAID IOTERMO CONSOLE 
10160 11 2? 40 21 JAID IOTERMO TERM 
20160 11 ?? 40 22 JAID IOTERMO TERM 
3 0160 11 2? 40 23 JAID IOTERMO TERM 
4 0160 11 2? 40 24 JAID IOTERMO TERM 
5 0161 11 2? 40 25 JAID LOTERHO TERM 
0 0178 0 0 TOINE INP1 
0 0173 0 0 INP2 
0 0180 0 0 CSSBSCO = SSLC2 
0 0410 128 0 IODSO HDS 1 
0 0410 128 0 IODSO HDS2 
0 0410 128 0 IODSO HDS3 
0 0410 128 0 IODSO HDS4 
0 0168 ?? 2? 40 60 J ID  IODSTRMO DSTERM 
0 0168 ?? 2 40 61 J ID  IODSTRMO DSTERM 
0 0168 ?? 2? 40 62 J ID  IODSTRMO DSTERM 
0 0168 ?? 2? 40 63 J ID  IODSTRMO DSTERM 
0 0168 ?? 2? 40 64 J ID  IODSTRMO DSTERM 
0 0168 ?? ?? 40 65 J 1D IODSTRMO DSTERM 
0 0 411 128 0 TOD: DSLINE1 
0 041 1 128 0 DSLINE2 
0 0168 ?? 2? 40 68 ID fODSTRMO INP1 
0 0168 ?? 2? 40 69 J ID  IODSTRMO INP2 
0 0410 2? 128 80 IODSO SDS 1 
0 0168 ?? 2? 36 71 J ID  IODSTRMO DSTERM 





Figure 2-6. Sample I/O Device Table (Telephone Line with INP) 
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Specifying an X.25 Line 

When specifying an X.25 line, you do not use the I/O device table. This is because X.25 uses node names, 
rather than LDEVs, to specify devices. To find out what node names are configured on your system, type 
the following: 

sRUN NETCONF .PUB.SYS 

>LIST 


See the DSN/DS HP 3000 to HP 3000 Network Administrator Manual for more information on 
NETCONF. 














‘DSLINE 


The format of the :DSLINE command, as used to open an HP 3000 to HP 1000 line, is presented here. In 





Syntax 


:DSLINE dsdevice 





The complete 


addition to opening a hardwired line or a telephone line, this command can also be used for closing one or 
more communications lines (discussed later in this section). 


[;LINEBUF=buffer-size] 

[ sEXCLUSIVE] 

[; QUIET] 

[ ; PHNUM=telephone-number ] 
[: 

[; 

[ 


LOCID=local-id-sequence | 
REMID=remote-id-sequence[,...remote-id-sequence] ] 
s OPEN | 


b 
+ 





NOTE 


syntax of the :DSLINE command includes parameters to 


indicate compression or no compression (COMP or NOCOMP). These 
parameters are not available on the HP 3000 to HP 1000 link. 





Parameters 


dsdevice 








(Required). This is the device class name or logical device number assigned 
to the DSN/DS communications driver (IODSO) during system 
configuration, or a logical node name for X.25. This parameter specifies 
what physical hardwired line or what communications interface (and 
modem) you wish to use. 


NOTE 


DSN/X.25 users should always use a node 
name rather than a line identifier. The 
logical node name appears in_ the 
configuration file for a Public Data Network 
(PDN). A Remote Node (RN) table relates 
the logical node name (specified in this 
command) to the logical device number of 
the appropriate IODSX driver (the X.25 
driver), and to the PDN address of the 
destination node. 


-DSLINE 


buf fer-size 


EXCLUSIVE 


QUIET 


(Optional). A decimal integer specifying the size (in words) of the DSN/DS 
line buffer to be used in conjunction with the communications line. The 
integer must be within the range 304 < buffer-stze < 4095 when used 
with the SSLC or HSI, and between 304 < buffer-size < 1024 when 
used with the INP. The default value is the buffer size entered in response 
to the PREFERRED BUFFER SIZE prompt during system configuration. 
This parameter overrides the MPE configured value when specified by the 
first user to open the given line. 


(Optional). This parameter, if present, specifies that you want exclusive use 
of the communications line. If the requested line or _ specified 
communications interface is already open and you have specified the 
EXCLUSIVE option, DSN/DS will deny you access to the line (you cannot 
open it). (See "Line Opening Failures" later in this section.) Opening an 
EXCLUSIVE line requires the user to have CS and ND capability. 


(Optional). When you issue the :DSLINE command with this parameter 
added, the message identifying the DS line number 1s suppressed. 


The additional parameters that pertain only to opening a telephone line are as follows: 


telephone-number 


Local-id-sequence 


(Optional). A telephone number consisting of digits and dashes. The 
maximum length permitted (including both digits and dashes) is 20 
characters. Provided that YES was entered in response to the 
DIAL FACILITY prompt during system configuration, this telephone 
number will be displayed at the operator’s console of your HP 3000 and the 
operator will then establish the telephone connection by dialing that 
number at the modem. (When the autodial feature is present in your 
system, the number provided here is dialed automatically.) The default 
telephone number is the one entered in response to the PHONE NUMBER 
prompt during system configuration. 


(Optional). A string of ASCII characters contained within quotation marks. 
If you wish to use a quotation mark within an ASCII string, use two 
successive quotation marks. The maximum number of ASCII characters 
allowed in the string is 16. 


The supplied string of ASCII characters defines the ID sequence that will be 
sent from your HP 3000 to the remote HP 1000 when you attempt to 
establish the telephone connection. If the remote HP 1000 does not 
recognize the supplied ID sequence as a valid one, the telephone connection 
is terminated. The default value is the ASCII string entered in response to 
the LOCAL ID SEQUENCE prompt during system configuration. 





“ 











remote-id-sequence 


OPEN 


:(DSLINE 


(Optional). Same format as Local-id-sequence. 


The supplied strings of ASCH characters define those remote HP 1000 ID 
sequences that will be considered valid when you attempt to establish the 
telephone connection. If the remote HP 1000 does not send a valid ID 
sequence, the telephone connection is terminated. The default set of 
remote ID sequences consists of the ASCII string entered in response to the 
REMOTE ID SEQUENCE prompt during system configuration. 


Opens a DS line. 
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Dialing the Remote Computer 


When you are opening a telephone line, you may supply a telephone number as an optional parameter in 
the :DSLINE command to be dialed at the modem connected to the specified INP or SSLC. If you supply 
a telephone number, DSN/DS displays a message on the system console telling the operator to dial that 
number. The operator, after dialing the specified number, enters YES or NO through the system console 
=REPLY command to let DSN/DS know whether or not the telephone connection was successfully made. 
If the operator enters YES, DSN/DS proceeds with the exchanging of ID sequences. If the operator enters 
NO, your :DSLINE request is denied (you cannot open the line). In either case,- your terminal’s keyboard is 
disabled until the console operator responds. 


If you do not supply a telephone number, the sequence of events is as described in the above paragraph, 
except that DSN/DS uses (by default) the first telephone number in the PHONELIST established during 
system configuration. 


If you do not supply a telephone number and no PHONELIST was established during system configuration, 
an I/O request message is displayed at the system console, but it does not include the number to be dialed. 
This method might be used when you will dial the remote HP 1000 yourself. Remember, however, that 
the console operator must still know whether you dialed successfully, since he must respond to the console 
message before you are granted access to the line. Because your terminal’s keyboard is disabled until the 
console operator responds with YES or NO, it is recommended that you always supply a telephone number 
in the :DSLINE command. 


ID Sequences 


Once a telephone connection to a remote HP 1000 exists, the two computers exchange ID sequences with 
one another. Within the context of DSN/DS, an ID sequence is a string of up to 16 ASCII characters that 
identifies a particular computer. 


During system configuration, each computer can be assigned a local ID sequence and a list of remote ID 
sequences. The local ID sequence identifies the particular computer in which it is established; the remote 
ID sequences identify those remote computers with which a communications link can be established over 
the public telephone network. 


In the :DSLINE command, you can supply (as optional parameters) a local ID sequence and one or more 
remote ID sequences to be used instead of those established during system configuration. (See Figure 2-9.) 


When a telephone connection is established between your HP 3000 and a remote HP 1000, the local ID 
sequence supplied in your :DSLINE command is transmitted to the remote system. The remote system 
then transmits its local ID sequence over the telephone line to your HP 3000. The received ID sequence is 
then compared against the remote ID sequence(s) supplied in your :DSLINE command. If that ID 
sequence is found to be valid, the telephone connection is considered successful and DSN/DS grants you 
access to the line. If the ID sequence received is not considered valid, your :DSLINE request is denied (you 
cannot open the line). 


If you do not supply any ID sequences, DSN/DS uses those established during system configuration. If no 
ID sequences were established during system configuration and you do not supply any, no local ID 
sequence is transmitted from your HP 3000 to the remote system and any remote ID sequence received 1s 
considered valid. 
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Multiple Users 


Within a DSN/DS environment, it is possible for several users at either end of the line to share access to 
the same physical communications line or for a single user at one end of the line to obtain exclusive access 
to the line. 


As previously mentioned in the discussion of the :DSLINE command, the EXCLUSIVE parameter can be 
used to obtain exclusive access to the specified physical communications line. If you specify this 
parameter (and if access to the line is granted), no other user in either computer will be permitted to open 
that line until you close it. If you ask for exclusive access to a particular line and that line is already in 
use, DSN/DS denies your request (you cannot open the line). (See "Line Opening Failures" later in this 
section. ) 


For hardwired lines and for dial-up lines, multiple users at either end of the line can specify the same 
physical line in :DSLINE commands and obtain access to that line as long as none of them requests 
exclusive access. In such a case, the users’ data 1s multiplexed, so that each user’s access to the line appears 
to be completely independent of all others. The exception for a telephone line is that all users, other than 
the one who originally opened the line, specify (explicitly or by default) the currently active remote ID 
sequence. Figures 2-7 through 2-11 present annotated examples, illustrating successful and unsuccessful 
attempts by different users to obtain access to the same line. 
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SYSTEM A 


SYSTEM B 









RSYS 1000 


SESSION RS Na Seema i octet a as eee ee cere 
—_ 
| \ SESSION 
~ 








Figure 2-7, Multiple User Example 1 





sHELLO USER.X >HELLO USER.Y 
:DSLINE RSYS1000 :DSLINE RSYS1000 
>REMOTE HELLO USER.X :REMOTE HELLO USER.Y 


In this example, User X initiates a local session in System A, obtains access to the hardwired 
communications line that connects System A to System B, and initiates a remote session in System B. 
User Y subsequently initiates a local session in System A, obtains access to the same communications 
line, and initiates a remote session in System B. The request by User Y for the particular 
communications line is granted by DSN/DS because neither user asked for exclusive access to the line. 
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SYSTEM A SYSTEM B 


TOCAL RSYS1000 REMOTE 
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Figure 2-8, Exclusive Option Example 





:HELLO USER.X :HELLO USER.Y 
:DSLINE RSYS1000;EXCLUSIVE :DSLINE RSYS1000 
:REMOTE HELLO USER.X 


In this example, User X initiates a local session in System A, obtains exclusive access to the hardwired 
communications line that connects System A to System B, and initiates a remote session in System B. 
User Y subsequently initiates a local session in System A and requests access to the same communications 
line. The request is denied by DSN/DS because User X already has exclusive access to the specified line. 
DSN/DS responds with: 


on DS LINE IN USE EXCLUSIVELY OR BY ANOTHER SYSTEM. (DSERR 241) 
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Configured Local ID: A Configured Local ID: B 
Configured Remote IDs: B,C Configured Remote IDs: A,C 
SYSTEM A SYSTEM B 





LOCAL RSYS 1000 
polities 
Cosson 
| \ SESSION 

~ 





Figure 2-9. Dial-up Line Multiple User Example 1 


sHELLO USER. X :HELLO USER.Y 
:DSLINE RSYS1000 & :DSLINE RSYS1000 & 
3; PHNUM=555-1234 & | ; PHNUM=555-1234 & 
;REMID="B" ;REMID= B- 
sREMOTE HELLO USER.X :REMOTE HELLO USER.Y 


In this example User X initiates a local session in System A and obtains access to the line identified by 
the device class name RSYS1000. The supplied telephone number is displayed at the system console of 
System A. The console operator establishes the telephone connection by dialing the number at the 
modem connected to the particular line and then enters YES through the system console to let DSN/DS 
know that the telephone connection was successfully made. The two computers exchange their 
configured local ID sequences. System A compares the received ID sequence (B) against the remote ID 
sequence specified by User X (REMID="'B"). Since the received ID sequence is found to be valid, the 
telephone connection is allowed to remain in effect. User X then initiates a remote session in System B 
over the telephone line from his local log-on terminal. 
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User Y subsequently initiates a local session in System A and requests access to the same line 
(RSYS1000). Since that line is already open, DSN/DS ignores the supplied telephone number (no 
message is displayed at the system console). Access to the currently opened line is granted to User Y 
because neither user requested exclusive access and User Y specified the currently active remote ID 
sequence (REMID="B") in his DSLINE command. 
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Configured LocalID: A | Configured Local ID: B 
Configured Remote IDs: B,C Configured Remote IDs: A,C 
SYSTEM A SYSTEM B 


RSYS 1000 





Figure 2-10, Dial-up Line Multiple User Example 2 





sHELLO USER. X :HELLO USER.Y 
:DSLINE RSYS1000 & :DSLINE RSYS1000 & 


; PHNUM=555-2001 & 


; PHNUM=555-1234 & 
= *REMID="C" 


;REMID="B" 


:REMOTE HELLO USER.X 


In this example User X initiates a local session in System A and obtains access to the line identified by 
the device class name RSYS1000. The supplied telephone number is displayed at the system console of 
System A. The console operator establishes the telephone connection by dialing the number at the 
modem connected to the particular line and then enters YES through the system console to let DSN/DS 
know that the telephone connection was successfully made. The two computers exchange their 
configured local ID sequences. System A compares the received ID sequence (B) against the remote ID 
sequence specified by User X (REMID="B"). Since the received ID sequence is found to be valid, the 
telephone connection is allowed to remain in effect. User X then initiates a remote session in System B 
over the telephone line from his local log-on terminal. 
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User Y subsequently initiates a local session in System A and requests access to the same line 
(RSYS1000). Since that line is already open, DSN/DS ignores the supplied telephone number and no 
message iS displayed at the system console. The request is denied by DSN/DS because the specified line 
is already open and User Y did not specify the currently active remote ID sequence (B) in the :DSLINE 
command. DSN/DS responds with: 





COMMUNICATIONS INTERFACE ERROR. UNANTICIPATED CONDITION. (DSERR 255) 
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Configured Local ID: (none) Configured Local ID: (none) 
Configured Remote IDs: (none) Configured Remote IDs: (none) 
SYSTEM A SYSTEM B 









___ 
SESSION fe lc a kaa yal 
a 
SESSION 
=~ 





Figure 2-11. Dial-up Line Multiple User Example 3 





sHELLO USER.X :HELLO USER.Y 
sDSLINE RSYS1000 ;PHNUM=555-1234 :DSLINE RSYS1000_ ;PHNUM=555-1234 
sREMOTE HELLO USER.XY :REMOTE HELLO USER.Y 


In this example User X initiates a local session in System A and obtains access to the line identified by 
the device class name RSYS1000. The supplied telephone number is displayed at the system console of 
System A. The console operator establishes the telephone connection by dialing the number at the 
modem connected to the particular line and then enters YES through the system console to let DSN/DS 
know that the telephone connection was successfully made. No ID sequences are exchanged because 
none were established (in either computer system) during system configuration and User X didn’t specify 
any in the :DSLINE command. User X then initiates a remote session in System B over the telephone 
line from his local log-on terminal. 
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User Y subsequently initiates a local session in System A and requests access to the same line (RSYS1000). 
Since that line is already open, DSN/DS ignores the supplied telephone number (no message is displayed at 
the system console). Access to the currently opened line is granted to User Y because neither user 
requested exclusive access and User Y specified the currently active remote ID sequence (in this case none) 
in his :DSLINE command. 


Note that when no ID sequences are configured and the users don’t supply any in their :DSLINE 
commands, both are taking it on faith that they are connected to the proper remote computer. In this 
example, if User Y had specified PHNUM=555-2001, DSN/DS would have ignored this telephone number 
because the line is already open. User Y would have been connected to the currently active remote 
computer rather than the requested remote system. The total absence of configured or supplied ID 
sequences is safe only under very controlled circumstances. It is strongly recommended that all computers 
in a DSN/DS network that are capable of communicating over telephone lines have default local and 
remote ID sequences established during system configuration and that all line users specify the ID 
sequence of the desired remote computer (REMID=x) in their :DSLINE commands. 


Opening Multiple Lines 


Within your local session, you can open more than one physical communications line and you can have 
remote sessions active concurrently over all of the opened lines. However, when operating without 
DSN/X. 25 capability, you are limited to one remote session per physical line at any given time. 


If access to the specified line is obtained, DSN/DS responds to each :DSLINE command by displaying a DS 
line number at your log-on terminal. This line number is roughly analagous to the file number returned 
by the MPE FOPEN intrinsic, in that it is an arbitrary number that uniquely identifies (within your local 
session) your current access to a particular communications line. It has no relationship to the logical 
device number or any other configuration parameter associated with the line. DS line numbers are 
meaningful only if you have more than one line open concurrently within a single local session. In that 
case, you are assigned a separate DS line number for each line you have opened, and you subsequently use 
these numbers to specify which line you wish to use for a given remote command (or sequence of remote 
commands) or to close a particular line without closing the others. 


Figure 2-12 illustrates a situation where a user has established two hardwired communications links 


concurrently from within a single local session. Take a closer look at that situation and examine the 
sequence of commands that was used to create it. 
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SYSTEM A RSYS!1 SYSTEM B 
/ (OS Line number 3) 


= 
SESSION -. —+/,- —~ —-— —- — — —\_ SESSION 


BN —__ rsvs2 


\ (DS Line number 4) 





User’s XN 
Log—on \ SYSTEM C 
Terminal N 


Figure 2-12. Multiple Line Example (Hardwired Lines) 


First, the user sat down at a terminal connected to System A and initiated a local session: 
:HELLO USER. ACCOUNT 
HP3000 / MPE IV C.00.04. WED, MAR 3, 1982, 1:37 PM 
WELCOME TO SYSTEM A. 


USER and ACCOUNT are valid user and account names, respectively as defined by the accounting structure 
of System A. 


The Communications Link 


Now, we have the situation illustrated in Figure 2-13. Notice that, at this point, no communications link 
exists between any of the three systems. 








SYSTEM A RSYSt SYSTEM B 
LOCAL 
SESSION 
| 





SYSTEM C 


User’s : 
Log~on 
Terminal 


Figure 2-13. Initiating the Local Session 
(Hardwired Example) 
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Next, the user acquired access to a line between Systems A and B. 
sDSLINE RSYS1 
DSLINE NUMBER = #L3 
RSYS1 is the device class name (as defined within System A) associated with the particular line. 


Now we have the situation illustrated in Figure 2-14. 


SYSTEM A RSYS! SYSTEM B 
/ (DS Line number 3) 


LOCAL REMOTE 
SESSION Jee ol Se — —\ SESSION 


SYSTEM C 





User’s f 
Log-on 
Terminal 


Figure 2-14, Establishing the Link With System B 
(Hardwired Example) 
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Finally, the user acquired access to a line between Systems A and C: 





:DSLINE RSYS2 
DS LINE NUMBER = #L4 
RSYS2 is the device class name (as defined within System A) associated with the particular line. 


We end up with the situation illustrated in Figure 2-15, which is identical to Figure 2-12 that started 
this example. 
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/ (OS Line number 3) 
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Figure 2-15. Establishing the Link With System C 
(Hardwired Example) 
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Figure 2-16 illustrates a situation where a user has established two telephone communications links 
concurrently from within a single local session. Take a closer look at that situation and examine the 
sequence of commands that was used to create it. 








SYSTEM A RSYS!1 SYSTEM B 
J (DS Line number 3) 















Log-on 
Terminal 


SYSTEM C 





Figure 2-16,. Multiple Line Example (Telephone Lines) 
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First, the user sat down at a terminal connected to System A and initiated a local session: 





>HELLO USER. ACCOUNT 

HP3000 / MPE IV C.00.04. WED, MAR 3, 1982, 1:37 PM 

WELCOME TO SYSTEM A. 
USER and ACCOUNT are valid user and account names, respectively as defined by the accounting structure 
of System A. 


At this point, we have the situation illustrated in Figure 2-17. Notice that, so far, no communications 
link exists between any of the three systems. 











SYSTEM B 
User’s 
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Terminal 


Figure 2-17. Initiating the Local Session 
(Dial-up Example) 
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Next, the user acquired access to a telephone connection between Systems A and B. | 
:DSLINE RSYS1 ;LOCID="A" ;REMID="B" ;PHNUM=257-8001 “ 
DS LINE NUMBER = #L3 

RSYS1 is the device class name (as defined within System A) associated with the particular line, A and B 

are the ID sequences identifying Systems A and B, respectively, and 257-8001 is the telephone number of 


the modem connected to the communications interface at System B. 


Now we have the situation illustrated in Figure 2-1 8. 


SYSTEM A RSYS1 SYSTEM B 
Z (OS Line number 3) 
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Figure 2-18. Establishing the Link With System B 
(Dial-up Example) 





2-36 


The Communications Link 


Finally, the user acquired access to a line between Systems A and C: 





:DSLINE RSYS2 ;LOCID="A" ;REMID="C" ;PHNUM=377-2000 

DS LINE NUMBER = #L4 
RSYS2 is the device class name (as defined within System A) associated with the particular line, A and C 
are the ID sequences identifying Systems A and C, respectively, and 377-2000 is the telephone number of 


the modem connected to the communications interface at System C. 


We end up with the situation illustrated in Figure 2-19, which is identical to Figure 2-16 that started 
this example. 





SYSTEM A RSYS1 SYSTEM B 
J (DS Une number 3) 
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Figure 2-19. Establishing the Link With System C 
(Dial-up Example) 
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Line Opening Failures 


There are several reasons why a :DSLINE command for opening a communications line might be rejected 
by DSN/DS, some of which have already been illustrated earlier in this section. If the :DSLINE command 
is not executed successfully, the error message may help identify the difficulty. The various error 
numbers and messages that might appear as a result of line opening failures are included in the summary 
of error codes and messages in Appendix A. 


The following list summarizes some likely causes of a line opening failure that are common to hardwired 
lines, leased lines, and dial-up telephone lines: 


You made a syntax error in the :DSLINE command. 

You gave an erroneous line specification (dsdevice) in the :DSLINE command. (There is no IODSO 
or IODSX entry in the system configuration with the specified device class name or logical device 
number. ) 

The line was not opened by the local console operator. 

The line was not opened by the remote console operator. 

Someone already has exclusive access to the specified line. 


You asked for EXCLUSIVE access to a line which was already in use. 


DSN/DS detected a hardware problem (the communications interface board is not responding 
correctly). 


The following list summarizes the additional causes of a line opening failure on a dial-up telephone line: 


e The operator was not able to make the requested telephone connection and entered NO through 


the system console in response to the dial request message. 


The remote computer rejected your local ID sequence. 


e The remote computer did not send a valid ID sequence (the received ID sequence did not match 


any of the remote ID sequences that you specified or, if you didn’t specify any, did not match any 
of the configured remote ID sequences). 


The specified line is already in use and the remote ID sequence you supplied did not match the 
one used by the currently connected remote HP 1000. 


Things to consider if you have experienced a line opening failure: 


Ensure :DSCONTROL Zdev,OPEN was accomplished. 


Ensure :RU,DINIT has been executed on the RTE system. And, if :DSCONTROL Zdev,OPEN was 
previously done, the: 
































The Communications Link 


<< HP 3000 COMMUNICATIONS LINK UP >> 


message will be displayed on the HP 1000 system console (displayed only if an HSI interface card 
is used). 


If previous line activity resulted in an error do :DSLINE Zdev;CLOSE and then try again to open 
the line with a :DSLINE ldev. 


In case of continuing problems consider any of the following: 


~ Enabling the line from the HP 1000 by :RU,DSMOD and using the /L command to re-enable 
the communication link used to communicate with the 3000. 


- Try to establish a remote session from the HP 1000 to the HP 3000 instead with: 


:RU,RMOTE 
#HELLO... 


- Try to reenable DSN/DS on the HP 3000 by ending the local session with a BYE command and 
then at the console enter: 


sDSCONTROL ldev,SHUT 
:DSCONTROL Ldev,OPEN 


Next, establish a new local session at the HP 3000 with the HELLO command. 


The :DSCONTROL Zdev,OPEN allocates the software and establishes the logical links between 
software modules. 


On the HP 1000, after the DINIT program is executed, an initialization message is sent 
establishing the buffer size. The initialization reply from the HP 3000 results in satisfactory 
completion, and a printing of the message (displayed only if an HSI interface card is used): 


<< HP 3000 COMMUNICATIONS LINK UP >> 


The Communications Link 
CLOSING A LINE 


Once you have opened one or more communications lines, you can close any or all of them by using a 
variation of the :DSLINE command. The line closing format of the :DSLINE command is presented here. 


Syntax 


dsdevice 
:DSLINE <ds-line-number >;CLOSE 
@ 





Parameters 

dsdevice (Optional). The device class name, logical device number, or logical node 
name specified in the :DSLINE command that opened a particular line. 

ds-line-number (Optional) The DS line number assigned to you by DSN/DS when the 
particular line was opened. When this parameter is used, it must appear in 
the format #Lv, where nv is the line number (see "Examples" on the 
following page). 

@ (Optional). This parameter specifies that you wish to close all of the lines 
that you currently have open. 

sCLOSE (Required). This parameter specifies that you wish to close the specified 


line(s). 


If no line identifier (dsdevice, ds-line-number, or @) is specified, DSN/DS closes the line that you 
most recently opened. 


Examples 


The following examples illustrate the variations of the :DSLINE command that can be used for closing 
one or more communications lines. 


:DSLINE RSYS1000 ;CLOSE 


This form closes the line that is identified by the device class name RSYS1000. 
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The Communications Link 
sDSLINE 55;CLOSE 


This form closes the line that is identified by the logical device number S45. 


:DSLINE @;CLOSE 


This form closes all the lines that you currently have open. 


:DSLINE #L3;CLOSE 


This form closes the line that is identified by #L3. 





:DSLINE;CLOSE 


This form closes the line that you most recently opened. 


If you are sharing one or more physical communications lines with other users, the above forms of the 
sDSLINE command close the line(s) for your application only (the other user’s applications are not 
affected). 
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SECTION 


A communications link exists after you have initiated some activity on the remote HP 1000. If the 
remote HP 1000 system allows session access, the DSN/DS software establishes a remote session using the 
RUSER.RGROUP specified in the REMOTE HELLO or uses the default username and groupname specified in 


the HP 1000 DINIT answer file. 
NOTE 


If your system does not support session access (HP 1000 A Series running 
RTE-A), you have access to ail system files on the 1000. A REMOTE HELLO 
is not possible. The term session is applied rather loosely in this section to 
differentiate between work done on the local system and work done on the 
remote system (as in local session versus remote session). 


REMOTE SESSIONS 





You now have two distinct sessions in existence simultaneously from the same log-on terminal: a local 
session (in the HP 3000 to which you first logged on) and a remote session (at the HP 1000 at the other 
end of the communications line). Now pause for a moment to see what this implies. 


Within the local session, you have access to all I/O devices and disc files in your local HP 3000 (subject to 
the usual MPE file security, of course). This is a normal MPE interactive session in every respect. You 
enter MPE commands and use the various language and utility subsystems exactly as you would if 
DSN/DS were not present. This local session is running under the username, accountname, and 
groupname specified in the :HELLO command that you used to first log on. All user capabilities and file 
access available to you within the local session are determined by those log-on parameters. 


With remote processing, you have access to the RTE operating system in the remote HP 1000 by entering 
RTE operator system commands exactly as you would if you were operating at the HP 1000 and the 
communications link were not present. The RTE operator commands are executed in the remote 
HP 1000, however, the output resulting from the executed commands appears at your log-on terminal. 


NOTE 


Only RTE system commands can be executed. There is no copy of FMGR 
for your session. 


For the sake of clarity and as a learning aid, the remainder of this section will treat local and remote 
sessions as separate (and essentially unrelated) entities that use only those resources available in the 
particular system in which they are running. Actually, it is possible to access the I/O devices and disc 
files of the remote HP 1000 computer from your local session. This more advanced activity will be 
covered in Section 4, "Executing Remote EXEC Calls," and Section 5, "Remote File Access." 
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Remote Sessions 
ISSUING REMOTE COMMANDS 


Remember that, in the previous sections, the following sequence of commands was used to establish the 
communications link: 


RETURN 
:HELLO USER. ACCOUNT 


HP3000 / MPE IV C.00.04. WED, MAR 3, 1982, 9:05 AM 


WELCOME TO SYSTEM A. 
sDSLINE RSYS1000 
DS LINE NUMBER = #L3 


At this point, the remote session has not been initiated; you are currently in the local session (as signified 
by the colon prompt character). To establish a remote session and execute a remote command, use the 
following construct: 


:REMOTE [xxx] command 


where xxx is the DS line number returned by DSN/DS when the communications line was opened, and 
command is the desired RTE command in its normal format. The DS line number is necessary only if you 
have more than one communications line open simultaneously; if it is omitted, then the line which you 
most recently opened is referenced by default. The HP 1000 operator command sent to the remote 
processor must follow the command syntax of the remote processor verbatim, and the first character must 
not be a numeric or a comma. Since different versions of RTE support different operator commands, 
consult the documentation provided with your RTE system to determine the exact format of your RTE 
commands. 


In the example in Section 1, the following construct was used to execute a TI command: 


sREMOTE TI 


1983 249 8 39 3 


Because the prefix REMOTE was included, the TI command is executed in the remote session. Although the 
TI command is executed in the remote HP 1000, the output generated by the command 1s displayed at 
your local log-on terminal. : : 


Notice, in the above example, that the DS line number associated with the particular communications line 
was not specified (3 in this example). This is because, if no line number is specified, DSN/DS uses (by 
default) the line most recently opened. Only one communications line is open from your local session; so 
DSN/DS uses that line by default. If you had opened a second line, you would need to tell DSN/DS in 
which remote computer the remote command is to be executed. To tell DSN/DS, include the appropriate 
DS line number in the remote command, as follows: 
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Remote Sessions 


sREMOTE 3 TI 


1983 249 8 39 3 


The above construct only allows you to execute a single remote command. After the remote command has 
been executed, control returns to your local session, as signified by the colon prompt character. 


But suppose that you want to execute a whole series of remote commands. It would obviously be a 
nuisance to have to prefix each command with the word REMOTE. DSN/DS provides a convenient solution 
to this situation. To execute a series of commands in the remote session, use the following construct: 


sREMOTE [xxx] 


where xxx is again the DS line number of the desired communications line (specifying in which remote 
HP 1000 we want to execute commands). DSN/DS then prompts you for each command by displaying a 
# prompt in column 1 of your terminal (in place of the standard MPE colon prompt). In the example in 
Section |, this construct was used for entering two remote RTE commands, EQ and UP. 


After reviewing the example in Section 1, try this example: 


: REMOTE 

#LU,1 

LU #1 = Ee 

#EQ,2 

16 DVROO 0 BU OO 
#; 


Notice that except for the # prompt (in place of the standard colon prompt) this looks exactly like a 
normal RTE operator’s session. All of the commands shown in the previous example are entered through 
the local log-on terminal, but the RTE operator commands are executed in the remote session within the 
remote HP 1000. After each remote RTE command was executed, however, control remained in the 
remote session (as signified by the # prompt character). When the user typed a colon (:) in response to 
the # prompt, control was then returned to the local session (as signified by the colon prompt). The 
remote session is terminated when the :DSLINE command is executed with the CLOSE parameter. 
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Remote Sessions 


Executable RTE Operator Commands 


While in a remote process on the HP 1000 system, you can use the RTE operator commands listed below: 


AB Abort current batch program 

BL Set buffer limits 

BR Set break flag in the ID segment of the named program 
DN Declare I/O device unavailable 

EQ Examine status of 1/O device 

GO Restart program out of suspension 

IT Set time intervals for programs 

LU Examine or alter device logical unit assignments 
OF Abort a program 

ON Schedule a program 

PR Change priority of programs 

PS Program status (L, XL, A) 

RU Start a program immediately 

RT Release disc tracks of a program 

SS Suspend programs 

ST Examine the status of programs 

TI Display the current time (IVB, 6/VM) 

™ Display the current time (L, XL, A) 

TO Examine or alter time-out parameter of an I/O device 
UP Declare I/O device available 

IO Examine I/O configuration (L, XL, A) 


NOTE 


Extreme care should be taken in modifying the RTE real-time clock since 
some programs, including Distributed System software, are scheduled at 
specific times. 


Syntax and further descriptions of these commands are included in the RTE Programmer's Reference 
Manual for each system. 


Using the Remote Subsystem from a Batch Job 


While in a batch job, you can establish a remote session by using the : DSLINE command. 
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Remote Sessions 


The job to be streamed may be similar to the following: 


: JOB USER. ACCOUNT 
:DSLINE RSYS1000 
:REMOTE HELLO RUSER.RACCOUNT 
:REMOTE 

#DN ,6 

#T0,6,500 

#UP 6 

#: 

REMOTE BYE 
:DSLINE;CLOSE 
:EOJ 


NOTE 


The remote # prompt is optional. 


An important point to remember is that, once established, the remote session is interacting with the job in 
the same way as it would interact with a terminal. If the remote session detects an error, the error 1s 
printed to $STDLIST. If the error generates a user prompt, the next record in the job file is read as the 
response (in the same manner as waiting for a character or carriage return on a terminal). The record is 
then lost to the job. 


ISSUING LOCAL COMMANDS 


Whenever the standard MPE colon prompt is displayed at your terminal, you are in the local session. 
Within the local session, you enter MPE commands in their normal format in response to the colon 
prompt. If you are in the midst of a remote session (that is, you used the command :REMOTE, and 
DSN/DS is issuing the # prompt character), you can return control to your local session by entering a 
colon, as follows: 


i 


eo 
° 


In response to the remote colon, control returns to the MPE Command Interpreter of your local HP 3000 
which then prompts you for local commands with the colon prompt character. Note that the remote 
colon does not terminate the remote session; you can resume processing in the remote session by again 
using either of the constructs described under "Issuing Remote Commands". 


TERMINATING A REMOTE SESSION 


To terminate the remote HP 1000 session, issue the :REMOTE BYE command, or :DSLINE;CLOSE. In the 
latter case, DSN/DS/1000-IV automatically terminates the HP 1000 session. 
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Remote Sessions 
LIMITATIONS 


There are certain limitations when you attempt to access the following RTE subsystems interactively: 


e The Editor. You are unable to edit a file. This is a subsystem that runs under the RTE operating 
system, and there is no facility to direct the dialogue back to the HP 3000 computer. 


e The File Management Program (FMGR). You are unable to run the FMGR control program directly 
with output to an HP 3000 terminal. You may create a transfer file containing the FMGR operator 
commands. Then you may run FMGR, specifying the file as follows: 


#RU, FMGR, TRFILE 
<_<» 


Command file in which you have 
stored the FMGR commands 


Command to execute FMGR 
Remote prompt from DS/1000-IV 


Output from the File Manager subystem can not be routed over the communications link back to the 
HP 3000. Instead, all output is directed to LUI. 


The request to RU,FMGR causes the actual FMGR program to run (not a 
copy of it). This will tie up FMGR until the transfer file has completed, 
and keep other users on the HP 1000 from logging on (they will not be able 
to get a copy of FMGR for their session). You must also be very careful to 
EX,SP from FMGR at the end of the transfer file or FMGR will be tied up 
to your session until you terminate it (BYE), or it times out. Exercise 
caution when running FMGR from the HP 3000. 
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SECTION 


EXECUTING REMOTE EXEC CALLS 





In the RTE operating system environment, EXEC calls are used by programs to interact with the system 
executive. DEXEC calls are the remote processing equivalent to the RTE EXEC calls, allowing you to 
interface with remote systems programmatically. A call to DEXEC will be processed by the EXEC 
module of the remote RTE operating system. 


By using DEXEC calls you can direct the RTE System Executive program to: 





Read from or write to a remote I/O device (excluding a DISC device). 
Perform I/O operations on remote I/O devices (excluding a DISC device). 
Schedule dormant remote programs for execution. 

Obtain the curent time from the remote real-time clock. 

Schedule remote programs for a set time of execution. 


Obtain status information about a remote I/O device. 


These calls are summarized in Table 4-1, which lists each DEXEC call with its instruction code and the 
function performed. For further information on DEXEC calls, you may want to refer to the appropriate 





RTE Programmer's Reference Manual which contains information on the nearly identical EXEC calls. 


The programmatic DEXEC calls described in this section can be used from an HP 3000 to an HP 1000. 
Prior to their use, the following commands must first be executed: 


:DSCONTROL Zdev;OPEN Console comand on HP 3000 to enable DSN/DS 
3000. 
:RU,DINIT On the HP 1000 to schedule various monitors and to 








enable the line. 


sDSLINE ldev In session on the HP 3000 to request the logical use 


of a DS line to the HP 1000. 
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Executing Remote Exec Calls 


Table 4-1. DEXEC Calls 


Instruction 
code Call Function 
a Reads a record from a remote I/O non-disc device. 
WRITE Writes a record on a remote I/O non-disc device. 


I/O CONTROL Performs an I/O control operation on a remote I/O 
device. 


|, PROGRAM SCHEDULE Schedules dormant remote programs for execution. 









TIME REQUEST Obtains the current time from the remote real-time 
clock. 
TIMED Schedules remote programs for a set time of 
PROGRAM SCHEDULE execution. 
1/O STATUS Obtains I/O status information from a remote I/O 
device. 
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Executing Remote Exec Calls 


a 


DEXEC CALL ELEMENTS 


EXEC calls and DEXEC calls are comparable in certain aspects such as parameter placement and meaning 
and the values returned in ABREG. DEXEC calls do have one additional parameter than EXEC calls. 
This is the destination parameter, named IDEST. The IDEST parameter is a five word integer array which 
contains the device class name or logical device number of the DS device and the DS line number. A 
complete description of IDEST appears for each of the calls in this section. 


NOTE 


In the discussion of each DEXEC call which follows in this section, you may 
be asked to refer to the RTE Programmer's Reference Manual appropriate 
for your HP 1000 system for RTE specific details. You may find that the 
names of the parameters for each call vary slightly depending on which 
RTE manual you reference. 


The format of a typical DEXEC call appears as follows: 


Syntax 


ABREG: = DEXEC (IDEST,ICODE ,ICNWD,IBUFR,IBUFL{ 





DEXEC call formats described in this section include superscripts that describe the types of parameters 
and whether they must be passed by value instead of by reference. The superscripts have the following 
meanings: 


BA byte array 

BP byte pointer 

D double word, by reference 
DA double word array 
DV double word, by value 
I integer by reference 
IA integer array 

IV integer by value 

L logical by reference 
LA logical array 

LV logical by value 

O-V option variable 

R real by reference 


The superscript O-V is shown for some DEXEC calls to denote an option variable, meaning that the 
DEXEC call contains optional parameters. 
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Executing Remote Exec Calls 


Functional Return 


The information returned in the A-register and B-register by DEXEC is the same as that returned by 
EXEC (refer to the appropriate Operating System reference manual) with additional DS/1000-IV error 
conditions and codes. The values of the A- and B-registers are returned immediately after the EXEC call 
is made on behalf of the program on the HP 3000. Applicable DEXEC error codes are listed in Appendix 
A of this manual. 


The following describes the possible outcomes : 


e CCL(<) Error detected by the HP 3000. The binary code in ABREG may contain a 
DEXEC, DS, or MPE file system error code. 


e CCG(>) Completed at communications level, but the HP 1000 detected anerror. A four 
character ASCII DEXEC error code is in ABREG. 


e CCE(=) The call was completed successfully. Registers contain status information, not 
error information. -_ 


Error Checking Routine Example 


The following example shows how to check for the failure of a DEXEC call. This example comes from a 
complete programming example that appears at the end of this section. You will need to refer to the 
complete programming example for the definition of the variables. 


PROCEDURE ERROR(CC,QUITNO) ; 
VALUE CC,QUITNO; 
INTEGER CC,QUITNO; 


BEGIN 
IF CC=-1 THEN <<DEXEC RETURNED CCL>> 
BEGIN 
MOVE MSG:="## HP 3000 DEXEC ERROR: "; . _ 
ASCII (ABREG(1) ,10,MSG(24) ) ; “- 
PRINT (MSGW,-25,0); | 
END 
ELSE IF CC=1 THEN <<DEXEC RETURNED CCG>> 
BEGIN 
MOVE MSG:="## HP 1000 DEXEC ERROR: "; 
MOVE MSGW(12):=ABREG, (2) 3 
PRINT (MSGW, 14,0); 
END; 
QUIT (QUITNO) ; 
END; 
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NOTE 


For detailed information about DEXEC calls, refer to the DS/1000-IV 
User's Manual and the EXEC call section of the RTE Programmer's 
Reference Manual appropriate for your system. 














READ 


The read call, instruction code 1, transfers information from a remote I/O device to a local user buffer. 


. 


Syntax 


D LA IV I IA I I 0-V 


ABREG: = DEXEC (IDEST,ICODE,ICNWD,IBUFR,IBUFL[, 





Functional Return 


Upon completion of the call, a doubleword ABREG is returned. Word 1, displayed in the A-register, 

contains status information, the equipment type code, and an availability indicator. Word 2, displayed in 

the B-register, shows the positive number of words or characters actually read, depending on how IBUFL Z 
was specified in the procedure call (+ for words, - for characters). Refer to the appropriate RTE a“ 
Programmer's Reference Manual for details. 


Parameters 


IDEST Logical array (required). A five word array that contains, in its first four 
words, an ASCII DS device class name or logical device number. The last 
word is used by the system to store the DS line number. 


ICODE Integer by value (required). Specifies the instruction code, which is 1 for a 
read call. 


ICNWD Integer by reference (required). The control word is an integer which 
specifies the logical control unit of the remote input device and other 
control information required by RTE. 


IBUFR Integer array (required), An array that will contain the information read 
from the device. You must insure the buffer is large enough to hold the “ * 
amount of data specified by ZBUFL. 


IBUFL Integer by reference (required). An integer specifying the number of words 
or characters to be read. If this value is positive it signifies the length in 
words; if it is negative it signifies the length in characters. The maximum 
buffer size for DEXEC requests is 512 words (1024 characters). 


IPRM? and IPRM2 Integer by reference (optional). Integer parameters which may be optional, 


depending on_the input device. Unlike a local RTE EXEC call, these 
parameters cannot be used to pass additional buffers. 
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Error Conditions 





Each DEXEC call should be followed with a test of the condition code, whose values indicate: 


CCE Satisfactory completion. The ABREG may contain information. Refer to the DEXEC 
call. 
CCL Error conditions on the HP 3000 end. Refer to Appendix A for DEXEC error codes. The 


binary value is contained in the ABREG. This value may also represent a DS or MPE file 
system error. 


CCG Error condition on the HP 1000 end. Refer to Appendix A for DEXEC error codes. The 
ASCII value is contained in the ABREG. 











WRITE 


The write call, instruction code 2, transfers information from a local user buffer to a remote I/O device. 


Syntax 


D 


Functional Return 


LA IV I IA I I I 0-V 





Upon completion of the call, a doubleword ABREG is returned. Word 1, displayed in the A-register, 
contains status information, the equipment type code, and an availability indicator. Word 2, displayed in 
the B-register, shows the positive number of words or characters actually read, depending on how IBUFL 
was specified in the procedure call (+ for words, - for characters). Refer to the appropriate RTE 
Programmer's Reference Manual for details. 


Parameters 


IDEST 


ICODE 


ICNWD 


IBUFR 


IBUFL 


IPRM1 and IPRM2 


Logical array (required). A five word array that contains, in its first four 
words, an ASCII DS device class name or logical device number. The last 
word is used by the system to store the DS line number. 


Integer by value (required). The instruction code is 2 for a write call. 


Integer by reference (required). The control word is an integer which 
specifies the logical control unit of the remote input device and other 
control information required by RTE. 


Integer array (required). An array that will contain the information read 
from the device. You must insure the buffer is large enough to hold the 
amount of data specified by ZBUFL. 


Integer by reference (required). An integer specifying the number of words 
or characters to be read. If this value is positive it signifies the length in 
words; if it is negative it signifies the length in characters. The maximum 
buffer size for DEXEC requests is 512 words (1024 characters). 


Integer by reference (optional). Integer parameters which may be optional, 
depending on the input device. Unlike a local RTE EXEC call, these 
parameters cannot be used to pass additional buffers. 














WRITE 





Error Conditions 


Each DEXEC call should be followed with a test of the condition code, whose values indicate: 


CCE Satisfactory completion. The ABREG may contain information. Refer to the DEXEC 
call. 
CCL Error conditions on the HP 3000 end. Refer to Appendix A for DEXEC error codes. The 


binary value is contained in the ABREG. This value may also represent a DS or MPE file 
system error. 


CCG Error condition on the HP 1000 end. Refer to Appendix A for DEXEC error codes. The 
ASCII value is contained in the ABREG. 
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I/O CONTROL 


The I/O control call, instruction code 3, carries out various operations such as backspace, rewind, and end 
of file, on a remote I/O device. 


Syntax 


D LA IV I I 0-V 





Functional Return 


The call returns the A-register and B-register in a double word. The A-Register contains the status of 
the device and EQT word 5. The B-Register has no meaning. Refer to the appropriate RTE 
Programmer's Reference Manual for details. 


Parameters 

IDEST Logical array (required). A five word array that contains, in its first four 
words, an ASCII DS device class name or logical device number. The last 
word is used by the system to store the DS line number. 

ICODE Integer by value (required). The instruction code is 3 for an I/O control 
call. 

ICNWD Integer by reference (required). The control word is an integer which 
specifies the logical unit of the remote I/O device and other control 
information information required by RTE. 

IPRM1 Integer by reference (optional). An optional parameter which is required 


for list output line spacing and various other functions. 


Error Conditions 


Each DEXEC call should be followed with a test of the condition code, whose values indicate: 


CCE Satisfactory completion. The ABREG may contain information. Refer to the DEXEC 
call. 
CCL Error conditions on the HP 3000 end. Refer to Appendix A for DEXEC error codes. The 


binary value is contained in the ABREG. This value may also represent a DS or MPE file 
system error. 


CCG Error condition on the HP 1000 end. Refer to Appendix A for DEXEC error codes. The 
ASCII value is contained in the ABREG. 
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PROGRAM SCHEDULE 


The remote program schedule call, instruction code 10, designates a dormant remote program for 
execution at the remote system and optionally transfers up to five parameters to the program. 


Syntax 


D LA IV IA _ ot 


I PRM3 | 


[77 





Functional Return 


If the program to be scheduled is dormant, it is scheduled by this call and a zero is returned to the calling 
program in the A-Register. 


If the program to be scheduled is not dormant, it 1s not scheduled by this call and its status, which is some 
non-zero value, is returned to the calling program in the A-Register. 


A-register: Meaning: 
0 Good return. 
l Program already scheduled. 
2 I/O suspend. 
3 Program in wait state. 
4 Unavailable memory suspend. 
5 Disc allocation suspend. 
6 Operator suspend, or program suspend. 


Parameters 

IDEST Logical array (required). A five word array that contains, in its first four 
words, an ASCII DS device class name or logical device number. The last 
word is used by the system to store the DS line number. 

ICODE Integer by value (required). The instruction code is 10 for a program 
schedule call. 

I NAME Integer array (required). A five character name array of the program to 
schedule. 

IPRM7 - IPRMS5 Integer by reference (optional). Up to five integer parameters to be passed 


to the scheduled program. 


PROGRAM SCHEDULE 


Error Conditions 


Each DEXEC call should be followed with a test of the condition code, whose values indicate: 


CCE 


CCL 


CCG 


Satisfactory completion. The ABREG may contain information. Refer to the DEXEC 
call. 


Error conditions on the HP 3000 end. Refer to Appendix A for DEXEC error codes. The 
binary value is contained in the ABREG. This value may also represent a DS or MPE file 
system error. 


Error condition on the HP 1000 end. Refer to Appendix A for DEXEC error codes. The 
ASCII value is contained in the ABREG. 














TIME REQUEST 


The time request call, instruction code 11, obtains the current time from the remote real-time clock and 


returns it to your terminal. 


Syntax 


D 


Parameters 


IDEST 


ICODE 


ITIME 


Error Conditions 


LA IV IA 





Logical array (required). A five word array that contains, in its first four 
words an ASCII DS device class name or logical device number. The last 
word is used by the system to store the DS line number. 


Integer by value (required). The instruction code is !1 for a time request 
call. 


Integer array (required). A five word array in which the current time is 
returned. 


ITIME (1) = tens of milliseconds 
ITIME (2) = seconds 

ITIME (3) = minutes 

ITIME (4) = hours 

ITIME (5) = day of year (Julian) 


Each DEXEC call should be followed with a test of the condition code, whose values indicate: 


CCE Satisfactory completion. The ABREG may contain information. Refer to the DEXEC 
call. 
CCL Error conditions on the HP 3000 end. Refer to Appendix A for DEXEC error codes. The 


binary value is contained in the ABREG. This value may also represent a DS or MPE file 


system error. 


CCG Error condition on the HP 1000 end. Refer to Appendix A for DEXEC error codes. The 
ASCII value ts contained in the ABREG. 


TIMED PROGRAM SCHEDULE (initial Offset) 


The remote timed program schedule call, instruction code 12, schedules a remote program for execution at 
specified time intervals, starting after an initial offset time. The requested program is placed in the time 
list. 


Syntax 


D LA IV IA I I I 


ABREG: = DEXEC (IDEST,ICODE,INAME,IRESL,MPTLE,IOFST) ; 





Parameters 


IDEST Logical array (required). A five word array that contains, in its first four 
words, an ASCII DS device class name or logical device number. The last 
word is used by the system to store the DS line number. 


ICODE Integer by value (required). The instruction code is 12 for a remote timed 
program schedule call. 


INAME Integer array (required). A three word integer array which names the 
remote program to put in the time list. 


IRESL Integer by reference (required). The value of resolution represents the units 
of time which, when used with the M7TPLE value, result in the total time 
intervals. Values for the resolution code are: 


1 = tens of milliseconds 
2 = seconds 

3 = minutes 

4 = hours 


MTPLE Integer by reference (required). Multiple is a number from 0 to 4095 
which is used with IRESL to give the actual time interval for scheduling. 
For example, if MTPLE is set to 3and IRESL is 2, the program will be 
scheduled every 3 seconds after an initial offset of JOFST seconds. If the 
parameter MIPLE is set to zero, the program is run only once. 


IOFST Integer by reference (required). JOFST is used with the value of ZRESL to 
define the initial time offset. It is a negative value representing the 
amount of time to wait before running the program for the first time. 





TIMED PROGRAM SCHEDULE (Initial Offset) 


‘- Error Conditions 


Each DEXEC call should be followed with a test of the condition code, whose values indicate: 


CCE Satisfactory completion. The ABREG may contain information. Refer to the DEXEC 
call. 
CCL Error conditions on the HP 3000 end. Refer to Appendix A for DEXEC error codes. The 


binary value is contained in the ABREG. This value may also represent a DS or MPE file 
system error. 


CCG Error condition on the HP 1000 end. Refer to Appendix A for DEXEC error codes. The 
ASCII value is contained in the ABREG. 














I/O STATUS 


The I/O status call, instruction code 13, obtains I/O status information about a remote I/O device. 





Syntax 


D LA IV I L L O-V 











Parameters 

IDEST Logical array (required). A five word array that contains, in its first four 
words, an ASCII DS device class name or logical device number. The last 
word is used by the system to store the DS line number. 

ICODE Integer by value (required). The instruction code is 13 for an I/O status 
call. 

ICNWD Integer by reference (required). The control word is an integer which 
specifies the logical unit of the remote I/O device and other control 
information required by RTE. 

ISTAT Logical (required). The status returned for EQT word 5. See the 
appropriate RTE Programmer's Reference Manual for details. 

ISTA2 Logical (optional). The status returned for EQT word 4. See the 


appropriate RTE Programmer's Reference Manual for details. 


Error Conditions 


Each DEXEC call should be followed with a test of the condition code, whose values indicate: 





CCE Satisfactory completion. The ABREG may contain information. Refer to the DEXEC 
call. 
CCL Error conditions on the HP 3000 end. Refer to Appendix A for DEXEC error codes. The 


binary value is contained in the ABREG. This value may also represent a DS or MPE file 
system error. 


CCG Error condition on the HP 1000 end. Refer to Appendix A for DEXEC error codes. The 
ASCII value is contained in the ABREG. 





PROGRAM EXAMPLE 


The following is an SPL program which uses the read and write DEXEC calls and also includes an error 
checking routine. 





$CONTROL USLINIT 
BEGIN 


COMMENT 
THIS PROGRAM PROMPTS THE USER FOR A MESSAGE TO BE 
WRITTEN TO THE REMOTE HP 1000 CONSOLE, AND THEN 
READS THE REMOTE HP 1000 OPERATOR’S RESPONSE. THE 
RESPONSE IS PRINTED ON THE HP 3000 USER’S TERMINAL; 


BYTE ARRAY BBUFFER(0: 79) ; 

BYTE ARRAY MSG(0:79); 

ARRAY DESTINATION(0:4):="NODE105 "; 
ARRAY MSGW(#)=MSG; 

INTEGER ARRAY BUFFER(#*)=BBUFFER; 
DOUBLE ABREG; 

INTEGER LGTH; 








PROCEDURE ERROR(CC,QUITNO); 
VALUE CC,QUITNO; 
INTEGER CC,QUITNO; 





BEGIN 
IF CC=-1 THEN <<DEXEC RETURNED CCL>> 
BEGIN 
MOVE MSG:="## HP 3000 DEXEC ERROR: "; 
ASCII (ABREG(1),10,MSG(24)); 
PRINT (MSGW, -25,0); 
END 
ELSE IF CC=1 THEN <<DEXEC RETURNED CCG>> 
BEGIN 
MOVE MSG:="## HP 1000 DEXEC ERROR: “; 
MOVE MSGW(12):=ABREG, (2); 
PRINT (MSGW,14,0); 
END; 
QUIT (QUITNO) ; 
END; 





LOOP: 
<<PROMPT USER FOR MESSAGE TO BE SENT TO REMOTE OPERATOR>> 


MOVE MSG:="ENTER MESSAGE FOR HP 1000 OPERATOR: "; 
PRINT (MSGW, -36 ,%320) ; 

LGTH: =READ( BUFFER, -80); 

IF (LGTH=0) THEN TERMINATE; 





PROGRAM EXAMPLE 


<<SEND MESSAGE TO THE HP 1000 SYSTEM CONSOLE>> 


pretieeiesriitsr iri ry 


IF < THEN ERROR(-1,1) 
ELSE IF > THEN ERROR(1,2); 


<<READ REMOTE OPERATOR’S RESPONSE>> 


IF < THEN ERROR(-1,3) 

ELSE IF > THEN ERROR(1,4); 
PRINT (BUFFER, -ABREG(2) ); 
GO LOOP; 


ABREG: =DEXEC (DESTINATION, 1,1,BUFFER, -80) 


END. 
































SECTION 


REMOTE FILE ACCESS 





Through the use of the DS/3000 Remote File Access capability, SPL, PASCAL, FORTRAN, or COBOL/II 
programs running in your local session can access any of the disc files of the remote HP 1000 (which are 
available to your session) as though they reside at your local HP 3000 site. 


NOTE 


RFA calls can only access FMGR files; you cannot access files in the 
hierarchical file system. 


This section discusses how you can use HP 3000 intrinsics to access HP 1000 files using DS. 
PROGRAMMATIC ACCESS 


Once a communications link has been established between your HP 3000 and remote HP 1000, you can 
use the Remote File Access (RFA) intrinsics to access files available to your session which reside at the 
remote HP 1000 site. Remote File Access provides the means to create, open, read, write, close, and 
control the files on the remote HP 1000 system. 


Table 5-1 lists the Remote File Access intrinsics, the corresponding RTE File Manager (FMP) call, and a 
corresponding description of each RFA intrinsic call. Refer to the RTE Programmer's Reference Manual 
for further information on FMP calls. 
These RFA intrinsics may be used from the HP 3000 to an adjacent HP 1000. Use of these intrinsics 
requires that the line be opened by the commands: 
:DSCONTROL ldev;OPEN Console comand on HP 3000 to enable DS/3000. 
:RU,DINIT On the HP 1000 to schedule various monitors and to 


enable the line. 


:DSLINE Zdev In session on HP 3000 to request the logical use of a 
DS line to the HP 1000. 


NOTE 


Multiple processes running under the same HP 3000 session cannot access 
the same HP 1000 file via RFA. 


Multiple processes under separate HP 3000 sessions may access the same 
HP 1000 file via RFA. 


el 


Remote File Access 
Table 5-1. RFA and FMP Cross Referencing \ 


RFA DESCRIPTION 


Positions disc files to a record. Record address usually 
obtained through DLOCF. 


Close DCB. Make file available to others. Can also 
truncate file. 


Perform I/O control function on non-disc device file, a 
type 0 file. 





Create a file. 

Return information on opened file. 

Close DCB and rename file. — 
Open file to calling program. 

Skip records forward or backward. 


Purge file. Cannot be opened. 





Read a record from a file to a user buffer. 


Return status of all mounted cartridges. 


Rewind type 0 files, including magnetic tape. Set to 
record | in disc file. 


Write a record from the buffer of a user to file. 























Remote File Access 


DESCRIPTION OF ERROR CONDITIONS AND PARAMETERS 


CCE No error with DSN/DS at either end. Check ZERRfor result on the HP 1000. If ZERR< 0, 
then there 1s an FMP error. 


CCL Indicates problems at the HP 3000end. Refer to Appendix A for summary of the RFA 
error codes. This value may also represent a DSN/DS/3000 subsystem or MPE file system 
error. 


CCG Not used. 


IERR Integer (required). The error code returned as a result of remote file access problems. 


The following example shows how to check for the failure of an RFA call. The example comes from a 
complete programming example that appears at the end of this section. 


Error Checking Routine Example 


PROCEDURE ERRORPROC(CC ,QUITNO) ; 
VALUE CC,QUITNO; 
INTEGER CC,QUITNO; 


BEGIN 
MOVE MSG(0):=" "; 
MOVE MSG(1):=MSG(0), (59); 
IF CC=-1 THEN <<RFA RETURNED CCL>> 
BEGIN 
MOVE MSG:="## HP 3000 RFA ERROR: "; 
ASCII (ERROR, 10,MSG(22)); 
PRINT(MSGI ,-25,0); 
END 
ELSE IF CC=0 THEN <<RFA RETURNED CCE WITH ERROR>> 
BEGIN 
MOVE MSG:="## HP 1000 RFA ERROR: "; 
ASCII (ERROR, 10,MSG(22)); 
PRINT (MSGI ,-25,0); 
END; 
QUIT (QUITNO) ; 
END; 


Remote File Access 
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NOTE 


If the file being accessed at the remote HP 1000 site is particularly large, 
you may get an error message at the HP 3000 site which indicates a remote 
reject error. In fact, the problem may be that a time out occurred at the 
remote HP 1000 site. The HP 3000 does not have an error message to 
indicate that this is the real problem. You may wish to verify a time out 
problem by looking at the error message that appears on the HP 1000 
system console or simply up the time out specificaton. Refer to the 
DS/1000-IV Network Manager's Manual, Vol. II for details. 


NOTE 


For detailed information on RFA calls, refer to the DS/1000-IV User's 
Manual and the RTE Programmer's Reference Manual appropriate for your 
system. 
































DAPOS 


Sets the address of the next record for sequential RTE disc file. 


Syntax 


LA I IV IV IV 0-V 





Parameters 

IDCcB Logical array (required). The Data Control Block (DCB) is a 4-word array 
used for each RTE file opened. This is used by the system and should not 
be modified. 

IERR Integer (required). Error code returned as the result of remote file access. 

IREC Integer by value (required). Record number of the next record in a 
sequentially numbered file. The first record is numbered starting with 1. 

IRB Integer by value (optional). Relative block number of the block containing 
the next record, from the DLOCF intrinsic. This parameter must be 
included for correct operation on files with variable length records. 

IOFF Integer by value (optional). A word offset, within a block, for the 


beginning of a new record, from DLOCF intrinsic. This parameter must be 
included for correct operation on files with variable length records. 


Error Conditions 


Follow each call to an RFA intrinsic with a test of condition codes. 


CCE No error with DSN/DS at either end. Check JERR for result on the HP 1000. If JERR < 
O, then there is an FMP error. 

CCL Indicates problems at the HP 3000 end. Refer to Appendix A for summary of the RFA 
error codes. This value may also represent a DSN/DS/3000 subsystem or MPE file system 
error. 

CCG Not used. 


DAPOS 


NOTE 


The DAPOS intrinsic allows random access of sequential files. 











DCLOS 


Closes the DCB and makes the RTE file available to other callers. 





Syntax 


I IV 0-V 


LA 
DCLOS (IDCB,IERR[,ITRUN] ); 








Parameters 

IDdcB Logical array (required). The Data Control Block (DCB) is a four word 
array used for each file opened. This is used by the system and should not 
be modified. 

IERR Integer (required). The error code returned as a result of remote file access. 

ITRUN Integer by value (optional). The number of blocks in the file to truncate: 


+N number of blocks to be deleted from the end of the file. 


-N delete all extents and retain the main file. 





0 the standard close; file closed without truncation. 


If the number of blocks specified in ITRUN is 
equal to the number of blocks in the file, the 
file is purged. 





Error Conditions 


Follow each call to an RFA intrinsic with a test of condition codes. 


CCE No error with DSN/DS at either end. Check TERR for result on the HP 1000. If TERR < 
: 0, then there is an FMP error. 

CCL Indicates problems at the HP 3000 end. Refer to Appendix A for summary of the RFA 
error codes. This value may also represent a DSN/DS/3000 subsystem or MPE file system 
error. 

CCG Not used. 
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DCLOS 
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NOTE 


The DCLOS intrinsic closes the Data Control Block, and makes the RTE file 
available to other callers. It also gives the user the option of truncating the 
file size when: 


The file is opened exclusively. 
e The current position is in the main file, not in the extent. 
e The security codes match at open. 


e The number of blocks to be truncated is less than or equal to the number 
of blocks in the file. 





























DCONT 


Sends standard RTE I/O control request to RTE type 0, non-disc, file. 


Syntax 


LA I IV IV Q-V 





Parameters 

IDCB Logical array (required). The Data Control Block (DCB) is a four word 
array used for each RTE file opened. This is used by the system and should 
not be modified. 

IERR Integer (required). Error codes returned as a result of remote file access. 

ICON! Integer by value (required). Control word specifying an action, such as, 
backspace one record or skip a line. See the appropriate RTE Programmer's 
Reference Manual for details. 

ICON2 Integer by value (optional). This value is required for some of the functions 


defined in ICON7, for example, to define the number of lines to be skipped. 
Refer to the appropriate RTE Programmer's Reference Manual for details. 


Error Conditions 


Follow each call to an RFA intrinsic with a test of condition codes. 


CCE No error with DSN/DS at either end. Check JERR for result on the HP 1000. If JERR < 
0, then there is an FMP error. 

CCL Indicates problems at the HP 3000 end. Refer to Appendix A for summary of the RFA 
error codes. This value may also represent a DSN/DS/3000 subsystem or MPE file system 
error. 

CCG Not used. 


DCRET 


Closes the DCB, if open, and creates the named RTE file on the specified disc with the specified number of 
blocks. 


Syntax 


LA I LA LA IV IV LA O-V 





Parameters 
IDCB Logical array (required). The Data Control Block (DCB) is a four word 
array used for each RTE file opened. This is used by the system and should 
not be modified. 
IERR Integer (required). Number of sectors or error code returned as a result of 
remote files access. 
NAME Logical array (required). RTE file name consisting of up to six characters. 
ISIZE Logical array (integer). Two word integer array. Word 1 specifes the 
number of blocks desired. If the number of blocks is less than 0, the whole 
disc is used. Word 2, used only for type 2 files, contains the record length 
in words. 
Word 1: The number of blocks desired. 
Word 2: The record length in words. Type 2 files. 
ITYPE Integer by value (required). Description of the file. 
0 non-disc file 
l fixed length 128-word record 
Z fixed length records; user defines length 
3 variable length records; sequential access, automatic 
extents 
4 ASCII code and source program (otherwise like type 3 
files) 
5 relocatable binary code (otherwise like type 3 files) 
6 save program file (otherwise like type 1 files) 
7 absolute binary (otherwise like type 3 files) 
8 - 32767 user defined 

















DCRET 


ISECU Integer by value (optional). Two character security code of the file. If 0, 
no security (default value); if > 0, any may read, specify to write; if < 0, 
specify to read/write. 





ICR Logical array (optional). Cartridge number; required during the first 
create. A five word array where: 


ICR [0] If 0, use any available cartridge; if >0, 
cartridge reference number; if <0, LU of the 
cartridge. 


IcR(1}-[4] ASCII representation of the DS device class 


name, logical device number, or node name for 
DS/X. 25. 


See the DS/1000-IV User's Manual for greater detail. 





Error Conditions 
Follow each call to an RFA intrinsic with a test of condition codes. 
CCE No error with DSN/DS at either end. Check JE@R for result on the HP 1000. If JERR < 


0, then there is an FMP error. DCRET will return a positive value in JERR upon successful 
completion to represent the number of sectors allocated to the file. 


eo CCL Indicates problems at the HP 3000 end. Refer to Appendix A for summary of the RFA 
error codes. This value may also represent a DSN/DS/3000 subsystem or MPE file system 
error. 
CCG Not used. 


NOTE 


The RTE file created by the DCRET intrinsic is left open 
exclusively to the caller upon successful completion of the 
intrinsic call. 





This intrinsic does not create a type O file. These are device files, such as line printers or card readers. 
Type 0 files may be created only by FMGR commands at the HP 1000. 


DLOCF 


Remotely accesses a DCB maintained in RTE to obtain location and status information about the next 
record. 


Syntax 


LA I I I I I I I I O-V 





Parameters 

IDCB Logical array (required). The Data Control Block (DCB) is a four word 
array used for each RTE file opened. This is used by the system and should 
not be modified. 

IERR Integer (required). The error code returned as a result of remote file access. 

TREC Integer (required). Returns the record number of next sequential record. 
Record numbers begin with 1. 

IRB Integer (optional). Returns the block number of the current block. 

IOFF Integer (optional). Returns a word offset, within the current block, at 
which the next record will begin. 

JSEC Integer (optional). Returns the number of sectors in the main file. 

JLU Integer (optional). Returns the logical unit number of the file on disc, or of 
the non-disc device for type 0 files. 

JTY Integer (optional). Returns the file type as indicated in DCB. 

JREC Integer (optional). Returns the record size in words. For type O files a 


read/write code is returned as follows: 


0123 45 6 7 8 9 10 141 #12 13 14 15 


w Reserved Ro 


R Read (Bit 15) = 1 
W Write (Bit 0) = 1 


: 


™. 











DLOCF 


Error Conditions 


( Follow each call to an RFA intrinsic with a test of condition codes. 


CCE No error with DSN/DS at either end. Check ZJERR for result on the HP 1000. If IERR< 
0, then there is an FMP error. 

CCL Indicates problems at the HP 3000 end. Refer to Appendix A for summary of the RFA 
error codes. This value may also represent a DSN/DS/ 3000 subsystem or MPE file system 
error. 

CCG Not used. 








DNAME 


Closes the DCB, if open, and renames the specified RTE file. 


Syntax 


LA I LA LA 


DNAME (IDCB,IERR,NAME ,NNAME[ 





Parameters 

IDcB Logical array (required). The Data Control Block (DCB) is a four word 
array used for each RTE file opened. This is used by the system and should 
not be modified. 

IERR Integer (required). Error code returned as a result of remote file access. 

NAME Logical array (required). Current RTE file name up to six characters. 

NNAME Logical array (required). New RTE file name up to six characters. 

ISECU Integer by value (optional). Two character security code of the old file. 

Remains unchanged. 

ICR Logical array. Required if file is currently open to user. A five word array 
where: 

ICR [0] Cartridge number. If specified the search is limited to 
just that cartridge. If not specified all cartridges are 
searched, but only the first file encountered with the 
old name is changed. 

ICR [1)-[4] ASCII representation of the DS device class name, 
logical device number, or node name for DS/X.25. 
DSLINE. 


Error Conditions 


Follow each call to an RFA intrinsic with a test of condition codes. 


CCE No error with DSN/DS at either end. Check IERR for result on the HP 1000. If TERR < 
O, then there is an FMP error. 

CCL Indicates problems at the HP 3000 end. Refer to Appendix A for summary of the RFA 
error codes. This value may also represent a DSN/DS/3000 subsystem or MPE file system 
error. 

CCG Not used. 














DOPEN 


Closes the DCB, if open, and opens the named RTE file. 


Syntax 


LA 6 LA IV IV LA O-V 





Parameters 

Idc8 Logical array (required). The Data Control Block (DCB) is a four word 
array used for each RTE file opened. This is used by the system and should 
not be modified. 

IERR Integer (required). The file type or error code returned as a result of 
remote file access. 

NAME Logical array (required). RTE file name assigned to file of up to six 
characters. 

IOPTN Integer by value (optional). This value specifies non-standard conditions 
desired when opening a file. See the DS/I000-IV User's Manual for 
details of the file options available. 

| NOTE 
The parameter JOPTN for: 
e A type 2 file must be modified in update 
mode. 
o A type 3, and greater, file is modified in a 
non-update mode, and writes an EOF 
after each record. 
ISECU Integer by value (optional). Two character or binary security code of the 


file. If 0, no security (default value); if > 0, any may read, specify to write; 
if < 0, specify to read/write. 


DOPEN 


NOTE 


If the file was created (see DCRET call) with a 
non-zero security code, this parameter must 
be specified and it must match the original 
security code assigned to the file. 





ICR Logical array (required during first open). A five word array where: 
ICR [0] Cartridge number. 
ICR (1)-[4] ASCII representation of the DS device class name, logical 


device number, or node name for DS/X. 25. 


See the DS/1000-IV User's Manual for details (RFA Call Parameter 
Variations). 





Error Conditions 
Follow each call to an RFA intrinsic with a test of condition codes. 
CCE No error with DSN/DS at either end. Check IERR for result on the HP 1000. If TERR < ~' 


O, then there isan FMPerror. DOPEN will return a positive value if the call is successfully 
completed to represent the file type. 


CCL Indicates problems at the HP 3000 end. Refer to Appendix A for summary of the RFA 
error codes. This value may also represent a DSN/DS/3000 subsystem or MPE file system 
error. 

CCG Not used. 














DPOSN 


Skips forward or backward a specified number of records, or to an absolute record number. 


Syntax 


LA I 


Iv IV 0-V 


DPOSN (IDCB,IERR,NUR[ IR); 





Parameters 


IDCB 


IERR 


NUR 


IR 


Error Conditions 


Logical array (required). The Data Control Block (DCB) is a four word 
array used for each RTE file opened. This is used by the system and should 
not be modified. 


Integer (required). Error code returned as a result of remote file access. 


Integer by value (required). The number of records to be skipped from the 
current file pointer position: 


+N number of records forward 
-N number of records backward 
0 no operation 


Integer by value (optional). The absolute or relative position of the record: 
O = NUR indicates a relative position. Default value. 


1 = NUR indicates an absolute record number within the file. 


Follow each call to an RFA intrinsic with a test of condition codes. 


CCE No error with DSN/DS at either end. Check JERR for result on the HP 1000. If TERR < 
0, then there is an FMP error. 


CCL Indicates problems at the HP 3000 end. Refer to Appendix A for summary of the RFA 
error codes. This value may also represent a DSN/DS/3000 subsystem or MPE file system 


error. 


CCG Not used. 


DPURG 


Closes the DCB, if open, and deletes the named RTE file and all its extents. 


Syntax 


LA I LA IV LA O-V 


47CR)); 





Parameters 

IDCB Logical array (required). The Data Control Block (DCB) is a four word 
array used for each RTE file opened. This is used by the system and should 
not be modified. 

IERR Integer (required). Error code returned as a result of remote file access. 

NAME Logical array (required). RTE file name consisting of up to six characters 
that identifies the file to be purged. 

ISECU Integer by value (optional). Two character security code of the file. If 0, 
no security (default value); if > 0, any may read, specify to write; if < 0, 
specify to read/write. 

ICR Logical array (required if file not presently open to the user). A five word 


array where: 
ICR [0] Cartridge number. 


ICR [1)-[4] ASCII representation of the DS device class name, 
logical device number, or node name for DS/X. 25. 


Error Conditions 


Follow each call to an RFA intrinsic with a test of condition codes. 


CCE No error with DSN/DS at either end. Check IEAR for result on the HP 1000. If IERR< 
0, then there 1s an FMP error. 

CCL Indicates problems at the HP 3000 end. Refer to Appendix A for summary of the RFA 
error codes. This value may also represent a DSN/DS/3000 subsystem or MPE file system 
error. 

CCG Not used. 























DREAD 


Reads a record from the RTE file currently open to DCB, to the user buffer. 


Syntax 


LA I LA IV I IV O-V 


DREAD (IDCB,IERR,IBUF ,IL[ 





Parameters 

IDCB Logical array (required). The Data Control Block (DCB) is a four word 
array used for each RTE file opened. This is used by the system and should 
not be modified. 

IERR Integer (required). The error code returned from accessing remote file. 

IBUF Logical array (required). The buffer to which data is read. 

Il Integer by value (required). A read request buffer length that specifies the 
number of words to be transferred. The buffer size is limited to 512 
words. 

LEN Integer (optional). Actual number of words transferred to the 
buffer. If length = -1, an end of file was read. 

NUM Integer by value (optional). Record number for random access type 1 and 


type 2 files: 
If NUM= 0, transfer starts at current pointer position (default). 


If NUM > OQ, transfer starts at absolute record position. 
If NUM < O, transfer starts at current position. 


Error Conditions 


Follow each call to an RFA intrinsic with a test of condition codes. 


CCE No error with DSN/DS at either end. Check JERR for result on the HP 1000. If IERR< 
0, then there is an FMP error. 

CCL Indicates problems at the HP 3000 end. Refer to Appendix A for summary of the RFA 
error codes. This value may also represent a DSN/DS/3000 subsystem or MPE file system 
error. 

CCG Not used. 


DSTAT 


Returns information on all cartridge labels in the RTE system. 





Syntax 


LA I LA O-V 


DSTAT (ISTAT,IERR,IDEST); 





Parameters 
ISTAT Logical array (required). A 125-word buffer for directory information. 
See the appropriate RTE Programmer's Reference Manual for details. 
IERR Integer (required). Error code returned as a result of remote file access. a 
IDEST Logical array (required). ASCII representation of the DS device class name, 


logical device number, or node name for DS/X. 25 (4-word array). 


Error Conditions 





Follow each call to an RFA intrinsic with a test of condition codes. 


CCE No error with DSN/DS at either end. Check IERR for result on the HP 1000. If ZERR< 
0, then there is an FMP error. 

CCL Indicates problems at the HP 3000 end. Refer to Appendix A for summary of the RFA 
error codes. This value may also represent a DSN/DS/3000 subsystem or MPE file system 
error. 

CCG Not used. 
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DWIND 


o Rewinds RTE device type 0 files and resets RTE disc files to the beginning of the first record in the file. 


Syntax 


LA 6Uf O-V 


DWIND (ZDCB8,IERR); 








Parameters 

IDCB Logical array (required). The Data Control Block (DCB) is a four word 
array used for each RTE file opened. This is used by the system and should 
not be modified. 

IERR Integer (required). Error code returned as a result of remote file access. 


Error Conditions 


Follow each call to an RFA intrinsic with a test of condition codes. 





CCE No error with DSN/DS at either end. Check IERR for result on the HP 1000. If TERR < 
0, then there is an FMP error. 


CCL Indicates problems at the HP 3000 end. Refer to Appendix A for summary of the RFA 
error codes. This value may also represent a DSN/DS/3000 subsystem or MPE file system 
error. 

CCG Not used. 
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DWRIT 


Writes a record on the RTE file currently open to the DCB from the user buffer. 


Syntax 





LA I LA IV IV 0-V 





Parameters 
IDCB Logical array (required). The Data Control Block (DCB) is a four word 
array used for each RTE file opened. This is used by the system and should 
not be modified. on 
IERR Integer (required). Error code returned as a result of remote file access. 
IBUF Logical array (required). Buffer from which data is written to record. 
IL Integer by value. Number of words from JBUF to be written. The buffer 
size is limited to 512 words. 
NUM 


Error Conditions 


Integer by value (optional). Record number for random access type | and Pau 
type 2 files: ) 


If NUM= 0, transfer starts at current pointer position (default). 
If NUM > 0, transfer starts at absolute record position. 
If NUM < 0, transfer starts at current position. 





Follow each call to an RFA intrinsic with a test of condition codes. 


CCE 


CCL 


CCG 
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No error with DSN/DS at either end. Check JERR for result on the HP 1000. If JERR < 
0, then there is an FMP error. 


Indicates problems at the HP 3000 end. Refer to Appendix A for summary of the RFA 
error codes. This value may also represent a DSN/DS/3000 subsystem or MPE file system 
error. 


Not used. 











a 


RFA EXAMPLE: SPL 


The following SPL/3000 program shows how remote files can be accessed using the remote file access calls 
to pass files between the HP 3000 and the remote HP 1000. 


$CONTROL USLINIT 
BEGIN 


COMMENT 


THIS PROGRAM TRANSFERS ONE ASCII RTE FILE TO AN MPE FILE. BECAUSE 

OF DIFFERENCES BETWEEN RTE AND MPE FILE FORMATS, THE RTE FILE IS 
TRANSFERRED AS 72-CHARACTER UNNUMBERED RECORDS. THE USER IS PROMPTED 
FOR THE NAME OF AN RTE FILE OR /E TO EXIT THE PROGRAM. AFTER THE RTE 
FILE IS OPENED, THE PROGRAM PROMPTS FOR THE NAME OF A NEW MPE FILE OR 
/E TO EXIT THE PROGRAM. THE PROGRAM THEN CREATES THE MPE FILE AND THE 
RECORDS ARE TRANSFERRED FROM THE RTE FILE TO THE MPE FILE. 

UPON COMPLETION, THE PROGRAM PRINTS THE NUMBER OF RECORDS 

TRANSFERRED AND TERMINATES; 


INTEGER FILENUM,ERROR,I,LGTH; 
INTEGER NORECORDS: =0; 


LOGICAL OPEN ,MOREDATA:=TRUE ; 


INTEGER ARRAY DCB(0:4), 
BUFFER(0:32), 
FILENAME (0:13), 
CRN(0:4); 


BYTE ARRAY MSG(0:59); 
BYTE ARRAY NUMBER(0:5); 
BYTE ARRAY FILENAMEB(#)=FILENAME; 


ARRAY MSGI(#)=MSG; 
ARRAY NUMBERI(#)=NUMBER; 


INTRINSIC FOPEN, FWRITE, FCLOSE, PRINT, READ, ASCII, BINARY, 


Pett SSSEtLLSRGE IDOLS SSLTL COLT EE ST TT IT IITA TERT TTIT TT TTT TTeiTy 


PRINT’FILE’INFO, QUIT, =DOPEN, = OREAD, =pClOs ; 


Federvetarnensene: 





Prot SeSiT TOES IST IT erect St iti) ee St tSterreriirei Piste errr iT ied 


PROCEDURE ERRORPROC(CC ,QUITNO) ; 
VALUE CC,QUITNO; 
INTEGER CC,QUITNO; 


BEGIN 
MOVE MSG(0):=" "; 
MOVE MSG(1): =MSG(0), (59); 
IF CC=-1 THEN <<RFA RETURNED CCL>> 
BEGIN 
MOVE MSG:="## HP 3000 RFA ERROR: "; 
ASCII (ERROR, 10,MSG(22) ); 
PRINT (MSGI ,-25,0); 
END 
ELSE IF CC=0 THEN <<RFA RETURNED CCE WITH ERROR>> 
BEGIN 


RFA EXAMPLE: SPL 


MOVE MSG:="## HP 1000 RFA ERROR: "; 
ASCII (ERROR,10,MSG(22)); 
PRINT (MSGI ,-25,0); 
END; 
QUIT (QUITNO) ; 
END; 





<<BEGIN MAIN CODE>> 


<<PROMPT USER FOR RTE FILE NAME, 
CARTRIDGE REFERENCE NUMBER AND DSLINE>> 
OPEN: =FALSE; 
WHILE NOT OPEN DO 
BEGIN 
MOVE MSG:="ENTER NAME OF RTE FILE: "; 
PRINT (MSGI ,12,%320) ; 
MOVE FILENAMEB:=28(" "); 
READ (FILENAME, -6); 
IF FILENAME(0)="/E" THEN GO TO ENDIT; > 


MOVE MSG:="ENTER CARTRIDGE REFERENCE NUMBER: °; 
PRINT(MSGI ,17,%320) ; 

MOVE NUMBER: =6(" "); 

READ(NUMBERI, -6) ; 

CRN(O):=BINARY (NUMBER,6) ; 


MOVE MSG:="ENTER THE DS DEVICE LDEV OR CLASS NAME: "3 

PRINT(MSGI ,20 ,%320) ; a“ 
MOVE CRN(1):=4(" "); 

READ(CRN(1),-8); 


| DOPEN(DCB,ERROR ,FILENAME ,%100,0,CRN); 
IF < THEN ERRORPROC(-1,1); 
IF ERROR < 0 THEN ERRORPROC(0,2); 
OPEN: =TRUE; 

END; 





<<PROMPT FOR MPE FILE NAME AND CREATE IT>> 
OPEN: =FALSE; 
WHILE NOT OPEN DO 
BEGIN 
MOVE MSG:="ENTER NAME OF MPE FILE: "; 
PRINT (MSGI, 12,%320) ; 
MOVE FILENAMEB:=28(" "); 
READ(FILENAME ,-28) ; 
IF FILENAME(0)="/E" THEN GO TO ENDIT; 
FILENUM: =FOPEN (FILENAMEB, 4,%344, 36); 
IF < THEN PRINT’FILE’ INFO(FILENUM) 
ELSE OPEN: =TRUE; 
END; 


<<TRANSFER DATA>> 
MOREDATA: =TRUE $ 
WHILE MOREDATA DO 
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RFA EXAMPLE: SPL 


PSttstirestittitistsetterretesy 


IF < THEN ERRORPROC(-1,3); 
IF ERROR < 0 THEN ERRORPROC(0,4); 
IF LGTH=-1 THEN MOREDATA: =FALSE 
ELSE 
BEGIN 
FOR I:=LGTH+1 UNTIL 35 DO BUFFER(I):=" "3; 
FWRITE(FILENUM, BUFFER(1),36,0); 
IF <> THEN 
BEGIN 
PRINT’FILE’INFO(FILENUM) ; 
MOREDATA: =FALSE3 
END 
ELSE NORECORDS : =NORECORDS+1 3 
END; 


END; 





IF < THEN ERRORPROC(-1,5); 

IF ERROR < O THEN ERRORPROC (0,6); 
FCLOSE(FILENUM,%11,0); 

MOVE MSG(0):=" "; 

MOVE MSG(1):=MSG(0), (59); 

MOVE MSG:="NUMBER OF RECORDS TRANSFERRED = "; 
ASCII (NORECORDS , 10,MSG(32)); 

PRINT(MSGI ,18,%40) ; 





END. 
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RFA EXAMPLE: FORTRAN 


The following FORTRAN program shows how to create a file on the remote HP 1000. 


$CONTROL INIT 
PROGRAM RFATR 
C THIS PROGRAM CREATES A NEW FILE ON THE RTE SYSTEM. 
C IT PROMPTS FOR INPUT, AND WRITES EACH RECORD 
C INTO THE NEW FILE USING RFA INTRINSICS. 
C UPON COMPLETION IT DISPLAYS THE CONTENTS, 
C AND CLOSES, AND TRUNCATES THE FILE. 
Cc 
C 
INTEGER BLOCKNUM, IERR, IERROR, ISIZE, LENGTH 
INTEGER OPTN, RECNM, SECURITY 
INTEGER TRUNCATE, TYPE 


LOGICAL CRTNM(S), DCB(4), NAME(3), SIZE(2) 
LOGICAL BUFFER(40) 


CHARACTER ANSW(6), BUFBYTE(72), BUFCHAR#72 
CHARACTER CRTBYTE(8) ,FORMALDES#8 

INTEGER BUFINTG(2) 

LOGICAL BUFPRNT (40) 


EQUIVALENCE (BUFFER, BUFBYTE) 
EQUIVALENCE (BUFFER, BUFINTG) 
EQUIVALENCE (BUFFER, BUFCHAR) 
EQUIVALENCE (CRTNM(2) ,CRTBYTE) 





SYSTEM INTRINSIC BPURE. BREAD. DWwRIT 
SYSTEM INTRINSIC FCHECK, FCLOSE, FOPEN 
SYSTEM INTRINSIC FREAD 


DATA FORMALDES/8H$STDINX / 


##e## MAIN PROGRAM ##### 


OO Oo 


WRITE(6,102) 

102 FORMAT(" BUILD FILE ON REMOTE RTE SYSTEM." ) 
WRITE(6,112) 

112 FORMAT(/,"+DSLINE NUMBER = ? ") 
DO 115 I=1,5 

115 CRTNM(I)=%20040L 
READ(5,#)CRTBYTE 

C 

120 WRITE(6,122) 

122 FORMAT("+SPECIFY NEW FILE NAME = ? ") 
DO 123 I=1,3 

123 NAME(I)=%20040L 
READ(5,124)NAME 

124 FORMAT(3A2) 


WRITE(6, 126) 
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126 FORMAT("+SPECIFY FILE SECURITY CODE ", 
«" (DEFAULT = 0) = ?") 


READ(S,130)SECURITY 
130 FORMAT(A2) 
c 
WRITE (6, 134) 
134 FORMAT("+SPECIFY CARTRIDGE NUMBER = ?") 
READ(5,201)CRTNM(1) 
201 FORMAT(A2) 
C 
C PREPARE TO DCRET 
c 
TYPE = 4 
C 
SIZE(1)=%100L 
C 


E(DCB,IERR,NAME,SIZE,TYPE,SECURITY, 





IF (.CC.) 1240,209,209 
209 IF (IERR) 1260,300,300 
C 
C OPEN TERMINAL AS FILE 
C 
300 IFN=FOPEN(FORMALDES) 
IF(.CC. )305,309,309 
305 CALL FCHECK(IFN,IERROR) 
WRITE (6,306) IERROR 
306 FORMAT(" FOPEN $STDINX FAILED, CCL. ERROR = ",I6) 
STOP 
C 
C FILE NOW CREATED 
C 
309 LENGTH = 36 
310 WRITE(6,312) 
312 FORMAT(" WRITE COMMANDS, TERMINATE WITH " 
#" STOP’ "/) 
C 
C LOOP 
C 
400 DO 410 I=1,36 
410 BUFFER(I)=%20040L 


: USE FREAD TO ALLOW ’:’ AND ’,’ 
° ICNT=FREAD(IFN, BUFFER, 36) 
IF(.CC.) 1050,420,600 
: TEST FOR '27” 
yer IF (BUFINTG(1.) .£Q.%37477) GO TO 1100 
TEST FOR ’STOP’ 


IF ((BUFINTG(1) .EQ.%51524) . AND. (BUFINTG(2) 
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620 
C 


C DCLOS COMPLETED. 


C 
675 


C 
690 
692 


Ooaqg 


700 


705 
Cc 

730 

(32 
Cc 


*.EQ.%47520)) GO TO 600 


WRIT (DCB, IERR, BUFFER, ICNT) 
IF(.CC.) 1020,430,430 





IF (IERR) 1000,400, 400 
OF LOOP 


WRITE (6,606) 
FORMAT (" BEGIN VERIFICATION: ") 


Pertriteetatitiiictisciits 


cost peterrrprrsseresrerts 
istesetoririperrorstrsrrs 


IF(.CC.) 1300,620,620 
IF(IERR) 1200,675,675 


CLOSE TERMINAL. 


CALL FCLOSE(IFN,0,0) 
IF(.CC.)690, 700, 700 


WRITE (6,692) 
FORMAT(" FCLOSE FAILED, CCL") 
STOP 


READ, VERIFY, AND TRUNCATE FILE 
OPEN OPTN=2 TO ALLOW TRUNCATION 


OPTN=2 


eet deoastateasasassvonse 


cercateetettunreseeronses 
Pritteriitrresr iter tes tts 


IF(.CC.) 1340, 705,705 
IF (IERR) 1360, 1370, 730 


WRITE(6, 732) IERR 
FORMAT(" FILE TYPE = ",I6) 


C VERIFY LOOP 


C 
740 
742 

C 
750 


C 
155 


760 


158 
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ISI ZE=36 
DO 742 I=1,40 
BUFFER (1I)=%20040L 


Ses teaeecteenreses aseres 
Heri teereerirerterrtar its 


IF(.CC.) 1380, 755, 755 


IF (ISIZE.EQ.0) GO TO 800 
IF(IERR.EQ.-12) GO TO 800 
IF (IERR) 1220, 760, 760 


BUF PRNT(1)=%20040L 
DO 758 I=1,39 
BUF PRNT(I+1)=BUFFER(I) 





RFA EXAMPLE: FORTRAN 


WRITE (6, 762) BUF PRNT 
762 FORMAT(40A2) 
C 





GO TO 740 
C 
C END VERIFY LOOP 
C 
C ENCOUNTERED END OF FILE 





IF(.cC.) 1320, 802, 802 
802 IF(IERR)1330,803,803 


803 TRUNCATE=64-(BLOCKNUM+1 ) 
CLOS( DCB, IERR, TRUNCATE) 

IF(.CC.) 1300, 805, 805 

805 IF(IERR) 1200, 820, 820 








820 WRITE(6,822) 
822 FORMAT(" PROGRAM COMPLETED") 
STOP 
C 
C ### ERROR CONDITIONS ### 
C 
C DWRIT ERRORS 
C 
1000 WRITE(6,1002)IERR 
1002 FORMAT(" DWRIT ERROR, IERR = ",I6) 
GO TO 600 





C 
1020 WRITE(6,1022)IERR 
1022 FORMAT(" CCL ON DWRIT, IERR = ",I6) 





STOP 
C 
1050 CALL FCHECK(IFN, IERR) 
WRITE(6,1052)IERR 
1052 FORMAT(" BAD READ FROM TERMINAL, IERR = ", 
#16) 
GO TO 310 
C 
C 


1100 WRITE(6,1110) 
1110 FORMAT(” GO TO ?? PART ") 
WRITE (6,1120) 
1120 FORMAT(" THIS PROGRAM CREATES A FILE ", 
#"ON THE RTE.") 
WRITE (6, 1130) 
1130 FORMAT(" IT WRITES THE COMMANDS, THEN", 
#" CLOSES THE FILE.) 
GO TO 310 
C 
C 
1200 WRITE(6,1202)IERR 
1202 FORMAT(" DCLOS ERROR, IERR = ",I6) 
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C 
1220 
1222 


C 
1240 
1242 


C 
1260 


1262 


C 
1270 
1272 


C 
1290 
1292 


C 
1300 
1302 


C 
1320 
1322 


C 
1330 
1332 


C 
1340 
1342 


C 
1360 
1362 


C 
1370 
1372 


C 
1380 
1382 


C 


STOP 


WRITE(6,1222)IERR 
FORMAT(" DREAD ERROR, IERR = ",I6) 
STOP 


WRITE(6,1242)IERR 
FORMAT (" CCL ON DCRET, IERR = 
STOP 


* IG) 


IF(IERR.EQ.-2) GO TO 1400 
WRITE(6,1262)IERR 

FORMAT (" DCRET ERROR, IERR = 
STOP 


" 16) 


WRITE(6,1272)IERR 
FORMAT(" CCL ON DPURG, IERR 
STOP 


" ,I6) 


WRITE(6,1292)IERR 
FORMAT (" DPURG ERROR, IERR = 
STOP 


", 16) 


WRITE(6,1302)IERR 
FORMAT (" CCL ON DCLOS, IERR 
STOP 


" 16) 


WRITE(6, 1322) IERR 
FORMAT(" CCL ON DLOCF, IERR 
STOP 


",I6) 


WRITE(6, 1332) IERR 
FORMAT(" DLOCF ERROR, IERR = 
STOP 


" 16) 


WRITE(6, 1342) IERR 
FORMAT(" CCL ON DOPEN, IERR 
STOP 


" 16) 


WRITE(6,1362)IERR 
FORMAT(" DOPEN ERROR, IERR = ",I6) 
STOP 


WRITE(6, 1372) 
FORMAT(" FAILED TO DOPEN FILE, IERR = 0") 
STOP 


WRITE(6,1382)IERR 
FORMAT(" CCL ON DREAD, IERR = ",I6) 
STOP 


C DUPLICATE FILE NAME IN DCRET 


C 
1400 


WRITE(6, 1402) 


RFA EXAMPLE: FORTRAN 


1402 FORMAT("+DUPLICATE FILE NAME, WISH TO ", 
#" PURGE (Y/N) = ?") 
READ(5,#) ANSW(1) 
IF (ANSW(1).EQ."N") GO TO 120 
IF (ANSW(1).EQ."Y") GO TO 1410 
GO TO 1400 
C 


terrisrrereririsrerrryi ety 
Ma istirret riersiesrstetery 


IF (.CC.) 1270, 1412, 1412 
c 
1412 IF(IERR) 1290, 1420, 1420 
c 
1420 CALL DGRET(DCB, IERR, NAME, SIZE, TYPE, 
#SECURITY, CRTNM) 


IF(.CC.) 1240, 1430, 1430 





C 
1430 IF(IERR) 1260,300,300 
C 





END 


























SECTION 


Eo 
COMMUNICATIONS | 6 | 


PROGRAM-TO-PROGRAM 





The preceding chapters describe how to establish communications links between HP 3000 and HP 1000 
computers in order to form a communications network, and how to execute programs in any HP 3000 or 
HP 1000 from a single log-on terminal. Furthermore, the programs running within any HP 3000 or 
HP 1000 in the DS network can, under the proper circumstances, access the hardware or software 
resources available at either end. 


However, for most remote processing applications it 1s essential that separate user programs be able to run 
simultaneously in separate computers within the network, and also be able to communicate efficiently 
with one another. The DSN/DS/3000 program-to-program (PTOP) intrinsics described in this chapter 
provide that capability. 


The structure of the two programs that are communicating with one another in this manner is not 
symmetrical. One of them, referred to as the master program, is always in control and is the one that 
initiates all activity between the two programs. The other, referred to as the slave program, is always 
responding to requests received from the master. Those intrinsics used within a master program are 
summarized in Table 6-1 and those used within a slave program are summarized in Table 6-2. 


The master program can reside on either the HP 3000 or HP 1000; the program residing on the system 
opposite of the master is called the slave. The program, either slave or master, residing on the HP 3000 
system can be written in SPL, FORTRAN, COBOL, BASIC, PASCAL, or COBOL/II. The program, slave or 
master, residing on the HP 1000 system can be written in FORTRAN, PASCAL or assembly language. 
The calling sequences of HP 1000 programs are described in the DS/1000-IV User's Manual. 


Table 6-1. Master Program-to-Program Intrinsics 


HP 1000 HP 3000 FUNCTION 


POPEN Initiates and activates a slave process in a remote system using a 
specified remote program file. 


PREAD Sends a request to the remote slave program asking the slave to 
send a block of data back to the master. 


PWRITE Sends a block of data to the remote slave program. 
PCONTROL Transmits a tag field containing user-defined control information 


to the remote slave program and receives a tag field back from 
the slave. 


PCLOSE Terminates the remote slave process. 


PCHECK Returns an integer code specifying the completion status of the 
most recently executed master program-to-program intrinsic. 
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Program-To-Program Communications 


The master program-to-program intrinsics are very similar to the MPE process handling and file system 
intrinsics that are used for process-to-process communication within a single-system environment. 


Table 6-2. Slave Program-to-Program Intrinsics 


HP 1000 HP 3000 FUNCTION 


GET Receives the next request from the master program. 


ACCEPT Accepts and completes the request received by the preceding GET 
intrinsic call. 


REJECT Rejects the request received by the preceding GET intrinsic call. 


PCHECK Returns an integer code specifying the completion status of the 
most recently executed slave program-to-program intrinsic. 


Terminates communication with a master program but resources 
are not released. The only released resources are those allocated 
by DS/1000-IV software. The ID segment for the slave will still 
exist. 





NOTE 


PCHECK is not required on the HP 1000 because there is an error parameter 
for each HP 1000 PTOP call. 


The HP 1000 program-to-program calls perform the same functions as their HP 3000 counterparts, but 
may have slightly different names for parameters. Refer to the DS/1000-IV User's Manual for details. 


Once a DS communications link exists between an HP 3000 and HP 1000, a user program (the master 
program) can create and activate a slave program. The POPEN intrinsic performs this function in place of 
the standard MPE CREATE and ACTIVATE intrinsics. 


When the master and slave program are both executing, the master program can send data (PWRITE) or 
control information (PCONTROL) directly to the slave program. The master can also send a read request 
(PREAD), or control request (PCONTROL) to the slave program asking that the slave send data and/or 
control information back to the master. 


When the master program in a master/slave pair exists on the HP 1000, the master program must make a 


call to HELLO to establish an HP 3000 session before calling POPEN to an HP 3000 slave program. Refer 
to the DS/1000-IV User's Manual for details. 
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Program-To-Program Communications 


Performance Considerations 


The communications system overhead for a PTOP transfer and an RFA transfer is comparable. However, 
when designing applications, PTOP solutions may provide greater throughput compared to RFA because of 
the ability to pack data into the buffer. The actual size of the PTOP transfer depends upon the buffer 
size library used in the HP 1000 system, along with the configured line size of the communications link as 
set by the DSCONTROL command. The three HP 1000 libraries allow data buffers of approximately 304, 
1072, and 4096 words. 


When an HP 3000 master communicates with a HP 1000 slave, the maximum total data buffer is either 


512, 1024 or 4096 words, depending upon which HP 1000 library is used. When a HP 1000 master 
communicates with a HP 3000 slave, it can transfer up to 4096 words. 


PTOP Intrinsics 


In the following descriptions of program-to-program intrinsics, superscripts are used to describe the types 
of parameters and whether they must be passed by value. The default is by reference. The superscripts 
have the following meanings: 


SUPERSCRIPT MEANING 


BA byte array 
BP byte pointer 
D double 
DA double array 
DV double by value 
I integer 
IA integer array 
IV integer by value 
L logical 
LA logical array 
LV logical by value 
O-V option variable 
R real 


6-3 


ACCEPT 


Accepts and completes the requests received by the preceding GET intrinsic call and returns an optional 
tag field to the remote HP 1000 master program. 


Syntax 


IA IA IV O-V 


a: 





The ACCEPT intrinsic accepts the request received by the most recent GET intrinsic call, completes the 
requested operation, and transmits an optional tag field back to the remote HP 1000 master program. 


In the case of a POPEN request, the ACCEPT call transmits an optional tag field, £7AG, to the remote 
HP 1000 master program. 


In the case of a PREAD request, the ACCEPT call transmits the specified number of words, TCOUNT, from 
TARGET to the remote HP 1000 master program and transmits an optional tag field, ITAG, to the remote 


HP 1000 master program. See Figure 6-1. 
NOTE 


You may want to refer to Figure 6-3 in conjunction with Figure 6-1. 
Figure 6-3 shows the GET activity with PREAD which would occur prior to 
the ACCEPT activity. 


In the case of a PWRIT request, the ACCEPT call moves the specified number of words, TCOUNT, from the 
DS buffer to TARGET and transmits an optional tag field, JTAG, to the remote HP 1000 master program. 


See Figure 6-2. 
NOTE 


You may want to refer to Figure 6-4 in conjunction with Figure 6-2. 
Figure 6-4 shows the GET activity with PWRIT which would occur prior to 
the ACCEPT activity. 


In the case of a PCONTROL request, the ACCEPT call transmits an optional tag field, ITAG, to the remote 
HP 1000 master program. 
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ACCEPT 


USER’S 


(HP 1000) (HP 3000) 
MASTER SLAVE 













ACCEPT 


USER’S 


Send optional 
tag field 


(dota). BUFFER 


HUFFER 





REJECT 







(No doto 
tranamitted) 





Figure 6-1. ACCEPT Activity for PREAD 
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Figure 6-2. ACCEPT Activity for PHRIT 
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ACCEPT 


Parameters 


ITAG 


TARGET 


TCOUNT 


Error Conditions 
CCE 
CCG 


CCL 
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Integer array (optional). A 20-word array used for transmitting a tag 
field. The format of the tag field is defined by the master and slave 
programs of the user. 


Integer array (optional). An array for transmitting or receiving blocks of 
data. 


For PREAD requests, this array contains the block of data to be transmitted 
to the remote HP 1000 master program. 


For PWRITE requests, this array receives the block of data from the DS 
buffer. 


For POPEN and PCONTROL requests, this array has no meaning and should be 
omitted. 


Integer by value (optional). An integer specifying the number of words (if 
positive) or bytes (if negative) to be transmitted or received. 


For PREAD requests, this parameter specifies how many words of data are to 
be transmitted from TARGET to the remote HP 1000 master program. 


For PWRITE requests, this parameter specifies how many words of data are 
to be moved from the DS buffer to TARGET. 


For POPEN and PCONTROL requests, this parameter has no meaning and 
should be omitted. 


Request completed successfully. 
Not returned. 


An error occurred. Issue a PCHECK intrinsic call to determine the 
DSN/DS/ 3000 subsystem or MPE file system error code. 


_ 














GET 


Slave callable. Receives the next request from the remote HP 1000 master program. 


Syntax 


I 0-V 





The GET intrinsic receives the next request from the remote HP 1000 master program and accepts an 
optional tag field, available in ITAG. 


Functional Return 


When the GET intrinsic is executed, it returns to the HP 3000 slave program a number, ifun, specifying 
the type of request received from the remote HP 1000 master program: 


ifun Meaning 
0 A error occurred. This value is returned only when the condition code 


CCL is also returned. Issue a PCHECK intrinsic call with a DSNUM 
parameter of zero to determine what happened. 


1 POPEN request received. 
2 PREAD request received. 
3 PWRIT request received. 
4 PCONT request received. 
5 This value is returned only when the condition code CCG is returned. It 


indicates that a pending MPE File System I/O-without-wait request was 
completed instead of a DS remote I/O request. The parameter IONUMBER 
contains the file number associated with the completed I/O request. 


The GET intrinsic call implicitly issues an IOWAIT(0O) intrinsic call. The parameter ifun value of 0 
indicates that an IOWAIT error occurred. An ifun value of 5 occurs only if you are executing MPE File 
System intrinsic calls without wait in your program and the implicit IOWAIT(0) call completes a pending 
File System I/O request instead of the expected DS remote I/O request. In this case you will have to issue 
another GET call after processing the completed File System I/O request in order to receive the expected 
DS remote I/O request. 


GET 


Parameters 


ITAG 


IL 


IONUMBER 


(HP 1000) 
MASTER 
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Integer array (optional). A 20-word array used for receiving a tag field. 
The format of the tag field is defined by the master and slave programs of 
the user. 


Integer (optional). A word that has meaning only when a PREAD or PWRIT 
request is received from the remote HP 1000 master program. For a PREAD 
request, JL contains an integer specifying the number of words requested by 
the remote HP 1000 master program. For a PWRIT request, Ji contains an 
integer specifying the number of words transmitted from the remote 
HP 1000 master program to the DS buffer. See Figures 6-3 and 6-4. 


Integer (optional). A word that has meaning only when the condition code 
CCG and an ifun of Sare returned. In this case, JONUMBER contains the 
MPE File System number associated with the completed I/O-without-wait 
request. The default is that no file number is returned. 


(HP 3000) 
SLAVE 


Send read request ond options! 
tag field. 


GET 


(Recelves tag 
and count for 
PREAD request) 


Figure 6-3, GET Activity with PREAD 
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GET 











(HP 1000) (HP 3000) 
MASTER SLAVE 
Ye ae Ee Eg eee eos ™ 
! Send write : 
request, ‘ 
GET ; 
' eptional tag 
field, ond (Receives tog and 
data count for 
PWRIT t 
USER’S ee DSN/DS 
BUFFER BUFFER 
Figure 6-4, GET Activity with PMHRIT 
Error Conditions 
CCE Request received successfully. 
CCG The implicit IOWAIT(0) call issued by the GET intrinsic completed a pending 


MPE File System I/O-without-wait request instead of a DS remote I/O 
request. The parameter, JONUMBER, contains the file number associated 
with the completed file system request. 





CCL An error occurred. Issue a PCHECK intrinsic call to determine the 
DSN/DS/ 3000 subsystem or MPE file system error code. 


NOTE 


You must not use IOWAIT(0) calls within a program containing DS GET 
calls. If you were to use an IOWAIT(O) call and it responded to a DS remote 
I/O request, your program would not be able to understand the information 
returned by the IOWAIT call. 
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PCHECK 


Returns an integer code specifying the completion status of the most recently executed DSN/DS 
program-to-program intrinsic. The PCHECK intrinsic may be used in both the master and slave programs. 


Syntax 


I IV 


icode: = PCHECK (DSNUM); 





Functional Return 


When the PCHECK intrinsic is executed, it returns to the calling program a number, icode, that specifies 
the completion status of the most recently executed DS program-to-program intrinsic. The values of 
icode and the associated meanings are described in Appendix A. 


Parameters 


DSNUM Integer by value (required). In a master program, DSNUM is the link 
identifier returned by the particular POPEN intrinsic that initiated 
communications with the remote slave program. Ina slave program, DSNUM 


is O (zero). 
Error Conditions 
CCE PCHECK request successfully completed. 
CCG Not returned. 
CCL PCHECK request denied because DSNUM was invalid. 











PCLOSE 


Master callable. Terminates program-to-program communciation with a remote HP 1000 slave program. 
on The DS line remains open. 


Syntax 


IV 


PCLOSE (DSNUM) ; 





Parameters 





DSNUM Integer by value (required). The line number returned by the particular 
POPEN intrinsic call which initiated communication with the remote 
HP 1000 slave program. 


Error Conditions 





CCE Successful completion. 
CCG Not returned. 
CCL Request denied; an error occurred. Issue a PCHECK intrinsic call to 


determine the DSN/DS/3000 subsystem or MPE file system error code. 


NOTE 


Although a master program normally signals the slave program to 
terminate by generating a code in the tag field, PCLOSE can be used to 
terminate the slave program unconditionally. However, make certain the 
HP 1000 slave program is not communicating with other master programs, 
since PCLOSE turns off the slave to other master programs also. 








PCONTROL 


Master callable. Exchanges tag fields with the remote HP 1000 slave program. 


Syntax 


IV 


IA O-V 


PCONTROL (DSNUM[,ITAG]); 





The PCONTROL intrinsic optionally transmits a tag field to the remote HP 1000 slave program and accepts 
one in return. The remote HP 1000 slave program must issue a GET intrinsic call followed by either an 
ACEPT or REJCT call to complete the PCONTROL operation. Both the ACEPT and REJCT calls transmit a 
tag field back to the master program, available in ITAG. 


Although this intrinsic was designed specifically to exchange tag fields, you will notice that ITAG is an 
optional parameter. If the master program did not transmit a tag field, then the returned tag field, if any, 


is not accessible. 


The PCONTROL activity is described in Figure 6-5. 


Parameters 


DSNUM 


ITAG 


Error Conditions 
CCE 
CCG 


CCL 


Integer by value (required). The link identifier returned by the particular 
POPEN intrinsic call which initiated communication with the remote 
HP 1000 slave program. 


Integer array (optional). A 20-word array used for transmitting and 


receiving a tag field. The format of the tag field is defined by the master 
and slave programs of the user. 


Request accepted by remote HP 1000 slave program. 
Request rejected by remote HP 1000 slave program. 


Request denied; an error occurred. Issue a PCHECK intrinsic call to 
determine the DSN/DS/3000 subsystem or MPE file system error code. 











(HP 3000) (HP 1000) 
MASTER SLAVE 


Send control request and optional 
tag field. 


PCONTROL 


Send optional 


tag field. 





Figure 6-5. PCONTROL Activity 


PCONTROL 
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POPEN 


Master callable. Initiates program-to-program communication with a remote slave program. 


Syntax 


I BA BA IA BA IV 


IV 
FLAGS] 


O-V 





The POPEN intrinsic activates a slave program in the remote HP 1000 having the specified program name, 
PROGNAME, and optionally transmits a tag field, TAG, to that remote HP 1000 slave program. 


The remote HP 1000 slave program must issue a GET intrinsic call followed by either an ACEPT or REJCT 
call to complete the POPEN operation. 


The remote HP 1000 slave program may transmit a tag field back to the master program as part of an 
ACEPT or REJCT call. If the master program transmitted a tag field, then the returned tag field, if any, is 
available in ITAG. If the master program did not transmit a tag field, then the returned tag field, 1f any, 
is not accessible. 


The remote HP 1000 slave program remains activated and the communications link intact even if the 
POPEN request is rejected by the remote HP 1000 slave program. The meaning of a POPEN reject by the 
remote HP 1000 slave program must be established as part of the user application design. 


Functional Return 


When the POPEN intrinsic is executed, it returns to the master program a number, dsnum, by which DS 
uniquely identifies the particular communications link. The POPEN activity described below is illustrated 
in Figure 6-6. 


Parameters 

DSDEVICE Byte array (required). Contains a string of ASCII characters terminated by 
a space. This string must be the DS device class name, logical device 
number, or node name for DS/X.25 for the communications line you will 
be using to access the remote HP 1000. 

PROGNAME Byte array (required). Contains a string of up to five ASCII characters that 
names a remote HP 1000 slave program. 

ITAG Integer array (optional). A 20-word array used for transmitting and 


receiving tag fields. The format of the tag field is defined as part of the 
user application. Default: A tag field of all zeros is sent; the returned tag 
field, if any, is not available to the master program. 











ENTRYNAME 
PARAM 
FLAGS 
STACKSIZE 
DLSIZE 
MAXDATA 


BUFSIZE 


Error Conditions 
CCE 
CCG 


CCL 


POPEN 


These are all MPE parameters used to specify program loading. They are 
ignored when the slave system is an RTE system. The commas must be 
included however since these are positional parameters. 


Integer by value (optional). The size in words of the communications 
buffer (DSN/DS buffer) that is established by the remote DSN/DS 
software. Note that this parameter defines the maximum number of words 
of data that can be transmitted by a PWRITE or PREAD intrinsic call. In the 
default condition, this value is the same size as the line buffer defined by 
the DSLINE command (LINEBUF=) for the first DSLINE issued to the 
dsdevice. It will never be smaller than 304 words. If no LINEBUF= is 
specified by the first DSLINE command, then the default configuration 
length is used. Must be equal to 138 for X.25. This parameter must be 
specified for a buffer of 342 words or greater. 


Request accepted by remote HP 1000 slave program. 
Request rejected by remote HP 1000 slave program. 


Request denied; an error occured. Issue a PCHECK intrinsic call to 
determine the DSN/DS/ 3000 subsystem or MPE file system error code. 


POPEN 


1) Schedule the remote slave program. 


(HP 3000) : ' (HP 1000) 
MASTER 2) Send optional tag field. ee 


GET 
DS/3000 
BUFFER 


Send optional 
tag field. 


REJCT 


ACEPT 
or 


Figure 6-6. POPEN Activity 


- 











PREAD 


Master callable. Asks the remote slave program to send a block of data. 


Syntax 


I IV IA IV IA O0-V 


lgth: = 





The PREAD intrinsic transmits a read request to the remote HP 1000 slave program and optionally 
transmits a tag field from ITAG to the remote HP 1000 slave program. The remote HP 1000 slave 
program must issue a GET intrinsic call followed by either an ACEPT or REJCT call to complete the PREAD 
operation. 


The ACEPT call moves the requested block of data from the user’s buffer in the remote HP 1000 system to 
TARGET in the master program. 


The REJCT call transmits no data, other than an optional tag field. 


The remote HP 1000 slave program may transmit a tag field back to the master program as part of the 
ACEPT or REJCT call. If the master program transmitted a tag field, then the returned tag field, if any, is 
available in ITAG. If the master program did not transmit a tag field, then the returned tag field, if any, 
is not accessible. 


Functional Return 


When the PREAD intrinsic is executed, it returns to the master program a number, lgth, specifying how 
many words (if TCOUNT is positive) or bytes (if TCOUNT is negative) of data were actually received into 
TARGET. The PREAD activity is illustrated in Figure 6-7. 


Parameters 

DSNUM Integer by value (required). The link identifier returned by the particular 
POPEN intrinsic call that initiated communication with the remote slave 
program. 

TARGET Integer array (required). The array into which data received from the 
remote slave program will be deposited. 

TCOUNT Integer by value (required). The positive number of words of data or the 
negative number of bytes of data requested. Data buffer sizes can be up to 
$12, 1024, or 4096 depending on the buffer size library generated in to the 
HP 1000 system to which the DS line is opened. See the DS/1000-IV 
Network Manager's Manual for details. 

ITAG Integer array (optional). A 20-word array used for sending and receiving a 


tag field. The format of the tag field is defined by the master and slave 
programs of the user. 


PREAD 


Frror Conditions 


CCE Request accepted by the remote HP 1000 slave program. 
CCG Request rejected by the remote HP 1000 slave program. 
CCL Request denied; an error occurred, Issue a PCHECK intrinsic call to 


determine the DSN/DS/3000 subsystem or MPE file system error code. 


(HP 3000) (HP 1000) 
MASTER SLAVE 


Send read request and 
optional tag field. 


TARGET 


Send 
USER'S optional 
BUFFER tag field. 
ACEPT 


~ (Send data from user’s 
(io, ™ buffer to remote master 
AT, ) program) 


USER'S 
BUFFER 


REJCT 
(no data transmitted) 





Figure 6-7, PREAD Activity 

















PWRITE 


Master callable. Sends a block of data to the remote HP 1000 slave program. 


Syntax 


IV IA IV IA O-V 





The PWRITE intrinsic transmits a block of data from TAAGET, and optionally transmits a tag field, ITAG, 
to the remote HP 1000 slave program. The number of words or bytes to be transmitted is specified in 
TCOUNT. The maximum number of words that may be transferred is 4096. 


The remote slave program must issue a GET call prior to accepting or rejecting the PWRITE request. GET 
returns information to the slave program concerning the nature of the master request, such as the length 
of the PWRITE data. The HP 1000 slave program may optionally receive the PWRITE information with 
the call to GET or wait until calling ACEPT. The remote HP 1000 slave program must issue a GET call 
followed by either an ACEPT or REJCT call to complete the PWRITE operation. 


The remote HP 1000 slave program may transmit a tag field back to the master program as part of the 
ACEPT or REJCT call. If the master program transmitted a tag field, then the returned tag field, if any, is 
available in I7AG. If the master program did not transmit a tag field, then any returned tag field is not 
accessible. 


The PWRITE activity is illustrated in Figure 6-8. 


Parameters 

DSNUM Integer by value (required). The link identifier returned by the particular 
POPEN intrinsic call which initiated communication with the remote 
HP 1000 slave program. 

TARGET Integer array (required). The array from which data is transmitted to the 
remote HP 1000 slave program. 

TCOUNT Integer by value (required). The positive number of words of data to be 
transmitted or the negative number of bytes. Data buffer sizes can be up 
to 512, 1024, or 4096 words depending on the buffer size library generated 
in to the HP 1000 that the DS line is open to. See the DS/1000-IV 
Network Manager's Manual for details. 

ITAG Integer array (optional). A twenty-word array used for sending and 


receiving a tag field. The format of the tag field is defined by the master 
and slave programs of the user. 


PWRITE 


Error Conditions 
CCE 
CCG 


CCL 


Request accepted by remote HP 1000 slave program. 


Request rejected by remote HP 1000 slave program. 


Request denied; an error occurred. 


Issue a PCHECK intrinsic call to 


determine the DSN/DS/3000 subsystem or MPE file system error code. 


(HP 3000) 


MASTER 


PWRITE 


USER’S 
BUFFER 


TARGET 


MASTER 
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(data) 


Send write request, optional 
tag field, and data. 


Send optional 
tag field. 





(HP 1000) 


GET 


(data from master is 
moved to user buffer 
or SAM) 


USER’S 
BUFFER 


ACEPT 


(if data is in SAM, 
its moved from SAM 
to user buffer here) 


REJSCT 


(data is not passed to 
slave program} 


Figure 6-8. PWRITE Activity. 

















REJECT 


Rejects the request received by the most recent GET intrinsic call and returns an optional tag field back to 
the remote HP 1000 master program. 





Syntax 


_TA O-V 





Parameters 


ITAG Integer array (optional). A 20-word array used for transmitting a tag 
field. The format of the tag field is defined by the master and slave 
programs of the user. 





Error Conditions 





CCE Response transmitted successfully to the remote HP 1000 master program. 
CCG Not returned. 
CCL An error occurred. Issue a PCHECK intrinsic call to determine the 


DSN/DS/3000 subsystem or MPE file system error code. 


NOTE 


See Figures 6-1 and 6-2 which appear in the discussion of ACCEPT. 
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PROGRAM EXAMPLES 


The following are examples of master program and slave program pairs. The examples include an 
HP 3000 master - HP 1000 slave pair and an HP 1000 master - HP 3000 slave pair. See the 
DS/1000-IV User's Manual for details on the HP 1000 PTOP calls. 





Example t: HP 3000 Master - HP 1000 Slave 


Master Program on the HP 3000 


This is a master program (JMAST) that runs on the HP 3000 and sends a buffer to a slave program on the 
HP 1000 where it is reversed and sent back. 


$CONTROL USLINIT 


BEGIN 





COMMENT 


THIS HP 3000 MASTER PROGRAM PROMPTS THE USER FOR A BUFFER 

BE SENT TO THE REMOTE HP 1000 SLAVE PROGRAM WHERE THE BUFFER 
IS REVERSED. THE HP 3000 THEN READS THE REVERSED BUFFER BACK 
AND PRINTS IT ON THE USER’S TERMINAL. ALL COMMUNICATION IS 
ACCOMPLISHED USING THE PTOP INTRINSICS. ; 





INTEGER DSNUM, ICODE, LGTH; 


BYTE ARRAY BUFFER(0:79) ; 

BYTE ARRAY DSLINE(0:7):="151 sa 
BYTE ARRAY MSG(0: 79); 

BYTE ARRAY PROGNAME(0:5):="JSLAV "; 


ARRAY IBUF (#)=BUFFER; 
ARRAY MSGI (#)=MSG; 





INTEGER ARRAY ITAG(0: 19); 


INTRINSIC ities aca cea 





PROCEDURE ERRORPROC(CC) ; 
VALUE CC; 
INTEGER CC; 


BEGIN 
IF CC=-1 THEN 
BEGIN 
ICODE : =: PGHE 
MOVE wsetoy:: va, 
MOVE MSG(1): =MSG(0), (79); 
MOVE MSG(0):="PTOP REQUEST FAILED. ERROR = "; 
ASCII(ICODE,10,MSG(30)); 
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a 


PRINT (MSGI ,-33,0); 
END; 


IF CC=1 THEN 
BEGIN 
MOVE MSG:="REMOTE REJECTED REQUEST”; 
PRINT (MSGI ,-23,0); 
END; 


END; 
<<BEGIN MAIN CODE>> 


<<POPEN REMOTE HP 1000 SLAVE PROGRAM>> 


PUYSTESISIST TITS ESET EST Sti 


PPisetoertes peri veer sieerr ser ss 
rittreritrersiristritesteetres 


BEGIN 
ERRORPROC(-1); 
GO TO ENDIT; 
END 
ELSE IF > THEN 
BEGIN 
ERRORPROC (1); 
GO TO ENDIT; 
END 
ELSE 
BEGIN 
MOVE MSG:="POPEN SUCCESSFUL"; 
PRINT (MSGI ,-16,0); 
END; 


<<PROMPT USER FOR BUFFER>> 


MOVE MSG:="ENTER BUFFER FOR TEST"; 
PRINT (MSGI,-21,0); 
LGTH: =READ(IBUF , 40); 


<<SEND BUFFER TO REMOTE>> 


ITAG(0):=LGTH; 
| PWRITE(DSNUM, IBUF ,LGTH,ITAG); 
IF < THEN 
BEGIN 
ERRORPROC(-1) ; 
GO TO ENDIT; 
END 
ELSE IF > THEN 
BEGIN 
ERRORPROC(1); 
GO TO ENDIT; 
END 
ELSE 
BEGIN 


PROGRAM EXAMPLES 
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PROGRAM EXAMPLES 


MOVE MSG:="PWRITE SUCCESSFUL" ; 
PRINT (MSGI ,-17,0); 
END; 
<<GET REVERSED BUFFER FROM REMOTE>> 


One resstevrearorevcnectsarace 


LGTH: = =PREAD (DSNUM, IBUF ,40,ITAG) ; 


Bescecectcesecousereuscseaeree 
PIrTereiitititisserese Tit str 


BEGIN 
ERRORPROC(-1); 
GO TO ENDIT; 
END 
ELSE IF > THEN 
BEGIN 
ERRORPROC (1); 
GO TO ENDIT; 
END 
ELSE 
BEGIN 
MOVE MSG:="PREAD SUCCESSFUL"; 
PRINT (MSGI,-16,0); 
PRINT (IBUF ,LGTH,O) ; 
END; 


<<SEND PCONTROL TO TELL SLAVE TO ABORT ITSELF >> 
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PROGRAM EXAMPLES 





slave Program on the HP 1000 


The following is the HP 1000 slave program that is associated with the HP 3000 master program, JMAST, 
previously illustrated. 














FTNTX 
PROGRAM JSLAV 
C 
C SLAVE. GET BUFFER, REVERSE IT, AND SEND BACK 
c 
INTEGER BUF (40),P(2),CLASS,TAG(20) , BUFR(40) 
c 
CALL RMPAR(P) 
CLASS = P(1) 
C 
1 CALL [GET 
GOTO (10,20,30,40) IFUN 
C 
C OPEN 
C 
10 CALL 
GOTO 1 
C 
C READ 
C 
20 CALL PT (TAG, IER, BUFR) 
GOTO 1 
C 
C WRITE 
C 
30 CALL | ACEPT (TAG, IER, BUF) 
c 
C REVERSE BUFFER 
C 





DO 31 I = 1,TAG(1) 
J=TAG(1)-I+1 
BUFR (J)=BUF (1) 
31 CONTINUE 
GOTO 1 


CONTROL 


Oo ©) 


40 CALL | ACEPT 


(TAG, IER) 





PPPETTTIRESIOSIECEISISSerietiyy 


CALL FINIS 
END 
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PROGRAM EXAMPLES 


Example 2: HP 1000 Master — HP 3000 Slave 


Master Program on the HP 1000 


This is a master program that runs on the HP 1000 and sends a buffer to a slave program on the HP 3000 
where it is reversed and sent back. 


NOOO MO 


Ooo oO OOO ON Oa Oo oo oe) OOD O AOD 


oO 
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PROGRAM JMAST 


THIS PROGRAM PROMPTS FOR AN INPUT BUFFER ON THE HP 1000, SENDS 
THE BUFFER TO A SLAVE PROGRAM ON AN HP 3000 WHICH REVERSES THE 
ORDER AND SENDS IT BACK AT THE REQUEST OF THE 1000 MASTER. 


INTEGER P(5),SNAM(3) ,BUF(40) ,PCB(4) ,TAG(20) ,AB(2) , BUF 1 (40) 
INTEGER LOGON(7),PRMT(6) 
EQUIVALENCE (REG, AB) 


SNAM THE NAME OF THE HP 3000 SLAVE PROGRAM 


LOGON THE CHARACTER STRING FOR INITIATING A LOGON REQUEST 
TO THE HP 3000 OPERATING SYSTEM 
PRMT = THE PROMPT ON THE HP 1000 TO INPUT THE BUFFER TO BE 


REVERSED 


DATA SNAM/GHJSLAV /,LOGON/14HHELLO RON.DS / 
DATA PRMT/12HINPUT BUFFER/ 


INITIATE A SESSION ON THE HP 3000 WITH A CALL TO HELLO 
THE LINK LU OF THE HP 3000 IN THIS CASE IS LU 94 


CALL HELLO (IERR,94,1,NMSMP, LOGON, 14) 


SCHEDULE THE SLAVE PROGRAM ON THE HP 3000 





FORMAT ("  IERR= ",14," CALL TYPE: “,I2) 


PROMPT FOR THE BUFFER TO BE REVERSED 
40 CHARACTERS MAXIMUM 


REG = DEXEC(-1,1,1+4400B, BUF , 40, PRMT,6) 


SEND THE BUFFER TO THE HP 3000 SLAVE PROGRAM 
THE LENGTH OF THE BUFFER IS IN THE FIRST WORD OF TAG 


TAG(1) = AB(2) 


CALL | PWRIT (PCB,IER,BUF,AB(2) ,TAG) 


Hiss 
eabes el eedeeesstesssesesives 





READ THE REVERSED BUFFER BACK FROM THE HP 3000 SLAVE 





























gam © om oie) 


Ooo oO 


PROGRAM EXAMPLES 


LENGTH OF THE BUFFER IS 40 CHARACTERS 


IL = 40 


Spee er atecee tees ennacstogs-ote 


CPRSS POTS TeSeeeS erry ebay es 
Breer cecanperserrassenserares 


IF (IER .LT. 0) WRITE (1,7) IER,2 
PRINT THE RETURNED BUFFER 


WRITE (1,9) BUF1 
FORMAT ("BUFFER IS ",/,40A2) 


CALL PCONT TO TELL THE SLAVE PROGRAM YOU ARE DONE 





CALL BYE TO LOG OFF THE CREATED HP 3000 SESSION ESTABLISHED 
IN THE CALL TO HELLO 


CALL BYE (IERR,94,1,NMSMP) 
END 


PROGRAM EXAMPLES 


slave Program on the HP 3000 


The following is the HP 3000 slave program that is associated with the HP 1000 master program, JMAST, 
previously illustrated. 


$CONTROL USLINIT 


C 
C 
C 


OOOO 
awh 


NON 0NO2AQNAaQO 


OOOO 


OOOO 


OOOO 


31 
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PROGRAM JSLAV 


DECLARE THE PTOP SUBROUTINE CALLS AS SYSTEM INTRINSICS. 





EL ,ACCEPT [REJECT 
INTEGER BUF (40), (2). ‘CLASS mary ,BUFR(40) 


INVOKE THE GET FUNCTION TO WAIT FOR MESSAGES FROM THE 
MASTER PROGRAM ON THE HP 1000 


3&1 (TAG, IL, ITONUMB) 





BRANCH TO THE APPROPRIATE PIECE OF SLAVE CODE TO HANDLE THE 
FUNCTION CODE RETURNED FROM THE GET 


FUNCTION CODES ARE: 
1 = POPEN, 2 = PREAD, 3 = PWRIT, 4 = PCONT, 5 = NO WAIT 1/0 


GOTO (10,20,30,40,50) ,IFUN 


POPEN CALL...CALL ACCEPT TO MASTER 
AND PERFORM ERROR CHECKING 





WRITE i sha IER,1 
GOTO 1 


PREAD CALL..CALL ACCEPT TO RETURN REVERSED BUFFER AND DO 
ERROR CHECKING 





WRITE = ROHR IER,2 
GOTO 1 


PWRITE CALL..CALL ACCEPT TO RETRIEVE BUFFER TO BE REVERSED AND 
DO ERROR CHECKING 





IER = 
WRITE (6. 1000) IER,3 


PROGRAM EXAMPLES 


REVERSE RETRIEVED BUFFER IN DO LOOP 


Oo oO 





33. DO 32 I = 1,TAG(1) 
J = TAG(1) - I +1 
BUFR(J) = BUF(I) 
32 CONTINUE 





GOTO 1 
C 
C PCONTROL CALL..CALL ACCEPT AND STOP PROGRAM 
C 

40 CALL | ACCERI(TAG) 

STOP 

c 
c NO WAIT I/O CALL ENCOUNTERED AT GET FUNCTION 
c DISPLAY ERROR INFORMATION AND RETURN TO GET FUNCTION 
C 


50 DISPLAY "GET DONE ON NO WAIT I/0, WHICH IS NOT A " 
DISPLAY "DS FUNCTION. RETURN TO GET 7 
DISPLAY "FILENUMBER = ",IONUMB 

1000 FORMAT ("PTOP ERROR. IERR = ",I5,"° CALL TYPE: ",12) 
GOTO 1 
END 
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APPENDIX 


ERROR CODES AND MESSAGES 





The following is a summary of the messages that may be encountered together with their meanings. The 
messages, as listed here, have been grouped according to their associated activities. For this reason, some 
messages are listed under more than one heading. 


Communications link errors may appear while using the :DSLINE command, Remote File Access (RFA), or 
program-to-program intrinsics. The method of reporting depends on the operation in progress when an 
error occurs. 


If you are performing remote FMP access, the error is returned in the error parameter. 


If you are using DEXEC calls, the error is returned as a four character ASCII code in the A and B 
registers. 





If you are using program~to-program operations, the error code is returned by the PCHECK intrinsic. 








DSN/DS/3000 SUBSYSTEM 


‘-DSLINE Syntax Errors 


These messages are sent to the terminal user to point out an error in syntax or to warn of the 
consequences of a request. 


1300 


1301 


1302 


1303 


1304 


1305 


1306 


1307 


1308 


1309 


1310 


1311 


1312 


1313 


1314 


1315 


1316 


1317 


1318 


1319 


1320 


1321 


1322 


REMOTE JOBS ARE NOT ALLOWED !. (CIERR 1300) 

DSLINE CANNOT CONTAIN BOTH OPEN AND CLOSE. (CIERR 1301) 

DSLINE REQUIRES AT LEAST ONE PARAMETER. (CIERR 1302) 

DSNUMBER SPECIFICATION MUST BE A NUMBER FROM 1 THRU 255. (CIERR 1303) 
DSLINE #1! DOES NOT IDENTIFY AN OPEN DS LINE. (CIERR 1304) 


EXPECTED LINEBUF, PHNUM, IOCID, REMID, OPEN, CLOSE, QUIET, COMP, NOCOMP, 
OR EXCLUSIVE. (CIERR 1305) 


MULTIPLE USE OF ! IS NOT ALLOWED. (CIERR 1306) 

THE SYNTAX FOR ! REQUIRES AN = SIGN FOLLOWED BY DATA. (CIERR 1307) 
PHNUM IS 1 TO 20 DIGITS AND DASHES. (CIERR 1308) 

! LIST CAN CONTAIN ONLY ONE ELEMENT. (CIERR 1309) 

THE SPECIFIED LOGICAL DEVICE IS NOT OPEN. (CIERR 1310) 

THE FIRST CHARACTER OF AN ID SEQUENCE MUST BE A " OR A ( (CIERR 1311) 
THE ID SEQUENCE MUST TERMINATE WITH A ). (CIERR 1312) 

THE ID SEQUENCE MUST TERMINATE WITH A“. (CIERR 1313) 

A NUMERIC ID SEQUENCE ELEMENT MUST BE 1 THRU 255 (OR %377). (CIERR 1314) 
LINEBUF MUST BE A NUMERIC VALUE FROM 304 THRU 4096. (CIERR 1315) 
UNABLE TO COMPLETE THE REMOTE COMMAND. (CIERR 1316) 

NOT A CURRENTLY AVAILABLE DSLINE. (CIERR 1317) 

USE OF EXCLUSIVE REQUIRES BOTH NS AND CS CAPABILITY. (CIERR 1318) 


THE DS LINE #L? IS IN USE BY A PROGRAM OR SUBSYSTEM AND CANNOT BE CLOSED. 
(CIERR 1319) 


EXPECTED A RESPONSE OF YES, Y, NO, OR N. (CIERR 1320) 
UNABLE TO OPEN THE DS LINE ON DEVICE !. (CIERR 1321) 


@ IS INVALID IN THIS CONTEXT. (CIERR 1322) 




















1323 


1324 


1325 


1326 


1389 


1390 


1391 


1392 


1393 


1394 


1395 


1396 


1397 


1398 


1399 


DSN/DS/3000 SUBSYSTEM 
A DSLINE OPEN REQUIRES A VALID DS DEVICE NAME AS THE FIRST PARAMETER. 
(CIERR 1323) 
FROM ADDRESS MUST BE BETWEEN 1 AND 14 CHARACTERS INCLUSIVE. (CIERR 1324) 
TO ADDRESS MUST BE BETWEEN 1 AND 14 CHARACTERS INCLUSIVE. (CIERR 1325) 
FROM AND TO ADDRESS MUST BE A DECIMAL NUMBER. (CIERR 1326) 
INVALID OR MISSING DELIMITER FOR SELECTION SIGNAL SEQUENCE. (CIERR 1389) 
SELECTION SIGNAL SEQUENCE MUST BE FROM 1 TO 30 CHARACTERS. (CIERR 1390) 
BOTH QUEUE AND NONQUEUE SPECIFIED; NONQUEUE USED. (CIWARN 1390) 
ONLY ! WORDS WERE ALLOCATED FOR THE LINE BUFFER. (CIWARN 1392) 


COMPRESSION REQUEST NOT HONORED. 
(CIWARN 1393) 


REMOTE DOES NOT SUPPORT THIS FEATURE. 
COMPRESSION PARAMETER RESPECIFIES AND OVERRIDES PREVIOUS COMPRESSION 
PARAMETER. (CIWARN 1394) 

OPEN PARAMETERS ENTERED ON A CLOSE REQUEST ARE IGNORED (CIERR 1395) 

AN ID LIST MUST CONTAIN 255 OR LESS ELEMENTS. (CIWARN 1396) 
AN UNNECESSARY DELIMITER IS IGNORED. (CIWARN 1397) 
THERE ARE NO DS LINES OPEN. (CIWARN 1398) 


MULTIPLE USE OF ! IS REDUNDANT AND IGNORED. (CIWARN 1399) 


DSN/DS Functional Errors 


These messages report a functional problem within the system. 


201 


202 


203 


204 


205 


206 


207 


REMOTE DID NOT RESPOND WITH THE CORRECT REMOTE ID. (DSERR 201) 


SPECIFIED PHONE NUMBER IS INVALID. (DSERR 202) 


REMOTE ABORT/RESUME NOT VALID WHEN DOING PROGRAM-TO-PROGRAM COMMUNICATION. 
USE LOCAL ABORT/RESUME. (DSWARN 203) 

UNABLE TO ALLOCATE AN EXTRA DATA SEGMENT FOR DS/3000. (DSERR 204) 
UNABLE TO EXPAND THE DS/3000 EXTRA DATA SEGMENT. (DSERR 205) 
SLAVE PTOP FUNCTION ISSUED FROM A MASTER PROGRAM. (DSERR 206) 


SLAVE PTOP FUNCTION OUT OF SEQUENCE. (DSERR 207) 
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208 


209 


210 


211 


212 


213 


214 


215 


216 


217 


218 


219 


220 


221 


222 


223 


224 


225 


226 


eer 


228 


229 


231 


232 


233 


MASTER PTOP FUNCTION ISSUED BY A SLAVE PROGRAM. (DSERR 208) 
SLAVE PROGRAM DOES NOT EXIST OR IS NOT PROGRAM FILE. (DSERR 209) 


WARNING -- INVALID MAXDATA OR DLSIZE FOR A SLAVE PROGRAM. SYSTEM DEFAULTS 
ARE IN EFFECT. (DSWARN 210) 


SLAVE ISSUED A REJECT TO A MASTER PTOP OPERATION. (DSWARN 211) 
FILE NUMBER FROM IOWAIT NOT A DS LINE NUMBER. (DSWARN 212) 
EXCLUSIVE USE OF A DS LINE REQUIRES BOTH ND AND CS CAPABILITY. (DSERR 213) 


THE REQUESTED DS LINE HAS NOT BEEN OPEN WITH A USER :DSLINE COMMAND OR A 
REQUIRED :REMOTE HELLO HAS NOT BEEN DONE. (DSERR 214) 


DSLINE CANNOT BE ISSUED BACK TO THE MASTER COMPUTER. (DSERR 215) 
MESSAGE REJECTED BY THE REMOTE COMPUTER. (DSERR 216) 
INSUFFICIENT AMOUNT OF USER STACK AVAILABLE. (DSERR 217) 

INVALID PTOP FUNCTION REQUESTED. (DSERR 218) 


MULTIPLE POPEN. ONLY ONE MASTER PTOP OPERATION CAN BE ACTIVE ON A DS LINE. 
(DSERR 219) 


PROGRAM EXECUTING GET WAS NOT CREATED BY POPEN. (DSERR 220) 
INVALID DS MESSAGE FORMAT. INTERNAL DS ERROR. (DSERR 221) 
MASTER PTOP FUNCTION ISSUED PRIOR TO A POPEN. (DSERR 222) 
REQUEST TO SEND MORE DATA THAN SPECIFIED IN POPEN. (DSERR 223) 
FILE EQUATIONS FOR A REMOTE FILE CONSTITUTE A LOOP. (DSERR 224) 
CANNOT ISSUE POPEN TO A SLAVE SESSION IN BREAK MODE. (DSERR 225) 
SLAVE PROGRAM HAS TERMINATED BEFORE EXECUTING "GET". (DSERR 226) 
REMOTE HELLO MUST BE DONE TO INITIATE REMOTE SESSION. DSERR 227) 
EXCEEDED MAXIMUM NUMBER OF VIRTUAL CHANNELS PER JOB. (DSERR 228) 


TOO MANY DS USERS ON THIS SYSTEM. CANNOT OBTAIN A VIRTUAL PROCESS NUMBER. 
(DSERR 229) 


INVALID FACILITY IN CONNECTION REQUEST. (DSERR 231) 
THE REMOTE COMPUTER IS NOT OBTAINABLE. (DSERR 232) 


VIRTUAL CIRCUIT IS NOT OBTAINABLE. (DSERR 233) 


234 





235 


236 


237 


238 


239 


240 


241 


242 





243 


244 


245 


246 





247 


248 


249 


250 


251 





252 


253 


254 


255 


256 
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QUEUEING IS REQUIRED TO COMPLETE THE REQUEST. (DSERR 234) 

DS MESSAGE SEQUENCING ERROR. (DSERR 235) 

COMMUNICATIONS HARDWARE HAS DETECTED AN ERROR. (DSERR 236) 
CANNOT CURRENTLY GAIN ACCESS TO THE TRACE FILE. (DSERR 237) 
COMMUNICATIONS INTERFACE ERROR. INTERNAL FAILURE. (DSERR 238) 
COMMUNICATIONS INTERFACE ERROR. TRACE MALFUNCTION. (DSERR 239) 
LOCAL COMMUNICATION LINE WAS NOT OPENED BY OPERATOR. (DSERR 240) 
DS LINE IN USE EXCLUSIVELY OR BY ANOTHER SUBSYSTEM. (DSERR 241) 
INTERNAL DS SOFTWARE ERROR ENCOUNTERED. (DSERR 242) 

THE REMOTE COMPUTER IS NOT RESPONDING. (DSERR 243) 


COMMUNICATIONS INTERFACE ERROR. THE REMOTE COMPUTER RESET THE LINE. 
(DSERR 244) 


COMMUNICATIONS INTERFACE ERROR. RECEIVE TIMEOUT. (DSERR 245) 
COMMUNICATIONS INTERFACE ERROR. REMOTE DISCONNECTED. (DSERR 246) 
COMMUNICATIONS INTERFACE ERROR. LOCAL TIME OUT. (DSERR 247) 
COMMUNICATIONS INTERFACE ERROR. CONNECT TIME OUT. (DSERR 248) 
COMMUNICATIONS INTERFACE ERROR. REMOTE REJECTED CONNECTION. (DSERR 249) 
COMMUNICATIONS INTERFACE ERROR. CARRIER LOST. (DSERR 250) 


COMMUNICATIONS INTERFACE ERROR. LOCAL DATA SET FOR THE DS LINE WENT NOT 
READY. (DSERR 251) 


COMMUNICATIONS INTERFACE ERROR. HARDWARE FAILURE. (DSERR 252) 


COMMUNICATIONS INTERFACE ERROR. NEGATIVE RESPONSE TO THE DIAL REQUEST BY 
THE OPERATOR. (DSERR 253) 


COMMUNICATIONS INTERFACE ERROR. INVALID I/O CONFIGURATION. (DSERR 254) 
COMMUNICATIONS INTERFACE ERROR. UNANTICIPATED CONDITION. (DSERR 255) 


REQUEST QUEUED BEHIND PREVIOUS REQUEST. (DSERR 256) 
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-DSCONTROL Informatory Messages 


These messages convey status information. 


300 


301 


302 


303 


304 


305 


306 


307 


308 


309 


310 


311 


312 


313 


314 


DS DEVICE $: MASTER AND SLAVE ACCESS SHUT. 

DS DEVICE !: SLAVE ACCESS OPENED; MASTER ACCESS SHUT. 
DS DEVICE !: MASTER ACCESS OPENED; SLAVE ACCESS SHUT. 
DS DEVICE !: MASTER AND SLAVE ACCESS OPENED. 

DS DEVICE !: TRACE ACTIVATED USING TRACE FILE !. 

DS DEVICE $: TRACE DEACTIVATED. 

DS DEVICE !: MONITORING ACTIVATED. 

DS DEVICE !: MONITORING DEACTIVATED. 

DS DEVICE !: DEBUG MODE ACTIVATED. 

DS DEVICE !: DEBUG MODE DEACTIVATED. 

DS DEVICE !: SPECIAL DEBUG MODE ACTIVATED. 

DS DEVICE !: DEFAULT MODE IS NO COMPRESSION. 

DS DEVICE $: DEFAULT MODE IS COMPRESSION. 

DS DEVICE $: RETRY COUNT NOW EQUALS !. 

DS DEVICE $: CALL REQUEST CANCELLED. 


‘DSCONTROL Error Messages 














These messages point out an error in syntax or warn of the consequences of a request. 


4100 


4101 


4102 


4103 


4104 


NUMBER OF PARAMETERS EXCEEDS MAXIMUM OF !. (CIERR 4100) 


EXPECTED AT LEAST TWO PARAMETERS: A DS DEVICE CLASS/NUMBER AND A FUNCTION 
KEYWORD. (CIERR 4101) 


EXPECTED A DEVICE CLASS NAME OR LOGICAL DEVICE NUMBER FOR ONE OR MORE DS 
DEVICES. (CIERR 4102) 


USER IS NOT ASSOCIATED WITH DS DEVICE !. NO CONTROL FUNCTIONS EXECUTED 
FOR THIS DEVICE. (CIWARN 4103) 


USER IS NOT ALLOWED TO USE :DSCONTROL AND IS NOT ASSOCIATED WITH THE DS 
DEVICE(S). (CIERR 4104) 

















4105 


4106 


4107 


4108 


4109 


4110 


4111 


4112 


4113 


4114 


4115 


4116 


4117 


4118 


4119 


4120 


4121 


4122 


4123 


4124 


4125 


4126 


4127 


4128 


4123 


DSN/DS/3000 SUBSYSTEM 
EXPECTED ONE OR MORE OF THE CONTROL FUNCTIONS: OPEN, SHUT, MON, MOFF, 
COMP, NOCOMP, TRACE, OR DEBUG. (CIERR 4105) 


INVALID CONTROL FUNCTION. EXPECTED ONE OF: OPEN, SHUT, MON, MOFF, COMP, 
NOCOMP, TRACE, OR DEBUG. (CIERR 4106) 


MASTER OVERRIDES PREVIOUS MASTER/SLAVE OPTION. (CIWARN 4107) 
SLAVE OVERRIDES PREVIOUS MASTER/SLAVE OPTION. (CIWARN 4108) 
SPEED OPTION OVERRIDES PREVIOUS SPEED OPTION. (CIWARN 4109) 
OPEN OVERRIDES PREVIOUS OPEN/SHUT FUNCTION. (CIWARN 4110) 
SHUT OVERRIDES PREVIOUS OPEN/SHUT FUNCTION. (CIWARN 4111) 
TRACE OVERRIDES PREVIOUS TRACE FUNCTION(S). (CIWARN 4112) 
DEBUG OVERRIDES PREVIOUS DEBUG FUNCTION(S). (CIWARN 4113) 
MON OVERRIDES PREVIOUS MON/MOFF FUNCTION. (CIWARN 4114) 

MOFF OVERRIDES PREVIOUS MON/MOFF FUNCTION. (CIWARN 4115) 
COMP OVERRIDES PREVIOUS COMP/NOCOMP FUNCTION. (CIWARN 4116) 
NOCOMP OVERRIDES PREVIOUS COMP/NOCOMP FUNCTION. (CIWARN 4117) 
EXPECTED A "3" , "," , OR RETURN AS DELIMITER. (CIERR 4118) 
EXPECTED EITHER A "3" OR RETURN AS DELIMITER. (CIERR 4119) 
EXPECTED A "=" AS DELIMITER FOR SPEED OPTION. (CIERR 4120) 
EXPECTED A "," AS DELIMITER BETWEEN OPTIONS. (CIERR 4121) 


ILLEGAL OPEN/SHUT OPTION. EXPECTED ONE OF: MASTER, SLAVE, SPEED, OR 
LINESPEED VALUE. (CIERR 4122) 


EXPECTED A POSITIVE DOUBLE VALUE FOR LINESPEED. (CIERR 4123) 

CS CAPABILITY REQUIRED TO USE :DSCONTROL. (CIERR 4124) 

PM CAPABILITY REQUIRED TO USE DEBUG FUNCTION. (CIERR 4125) 
DEBUG FUNCTION MAY ONLY BE USED BY SYSTEM CONSOLE. (CIERR 4126) 


EXPECTED NO OPTION FOR DEBUG OR ONE OF THE FOLLOWING: ON, OFF, OR POSITIVE 
INTEGER VALUE. (CIERR 4127) 


EXPECTED NO OPTION FOR MON/MOFF OR ONE OF THE FOLLOWING: CS OR DS. (CIERR 
4128) 


COMP/NOCOMP FUNCTIONS HAVE NO OPTIONS. (CIERR 4129) 
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4130 
4131 
4132 
4133 
4134 
4135 
4136 
4137 


4138 


4139 


4140 


4141 


4142 


4143 


4144 


4145 


4146 


4147 


4148 


4149 


4150 


4151 


4152 


4153 


4154 


SPEED OPTION IGNORED FOR SHUT FUNCTION. (CIWARN 4130) 


EXTRANEOUS "3" IGNORED. POSSIBLE MISSING FUNCTION? (CIWARN 4131) 


EXTRANEOUS "," IGNORED. POSSIBLE MISSING OPTION? (CIWARN 4132) 


CREATION OF DS MONITOR PROCESS FAILED. (CIERR 4133) 


PROGRAM FILE "DSMON.PUB.SYS" MISSING. (CIERR 4134) 


DS MONITOR UNABLE TO RUN AS A SYSTEM PROCESS. (CIERR 4135) 


CS DEVICE ! IS UNAVAILABLE FOR USE. (CIERR 4136) 


DS DEVICE MUST BE OPEN PRIOR TO USE. (CIERR 4137) 


USER SPECIFIED TRACE FILE NOT ALLOWED WHEN MORE THAN ONE DEVICE IN DEVICE 
CLASS. (CIERR 4138) 

DS DEVICE ! CURRENTLY CONTROLLED ELSEWHERE. (CIWARN 4139) 
DS DEVICE !: OPEN/SHUT NOT EXECUTED DUE TO ABOVE. (CIWARN 4140) 
DS DEVICE !: TRACE NOT EXECUTED DUE TO ABOVE. (CIWARN 4141) 
DS DEVICE !: MON/MOFF NOT EXECUTED DUE TO ABOVE. (CIWARN 4142) 
DS DEVICE !: COMP/NOCOMP NOT EXECUTED DUE TO ABOVE. (CIWARN 4143) 
DS DEVICE !: DEBUG NOT EXECUTED DUE TO ABOVE. (CIWARN 4144) 
NO DS DEVICES REMAINING TO BE CONTROLLED. (CIWARN 4145) 
RETRY OVERRIDES PREVIOUS RETRY FUNCTION. (CIWARN 4146) 
EXPECTED AN "=" AS DELIMITER FOR RETRY FUNCTION. (CIERR 4147) 


INVALID RETRY COUNT, MUST SPECIFY “DEFAULT” OR A NUMBER BETWEEN O AND 255 
INCLUSIVE. (CIERR 4148) 

DS DEVICE $: RETRY NOT EXECUTED DUE TO ABOVE. (CIWARN 4149) 
DS INTERNAL FIX NUMBERS DIFFER. (CIWARN 4150) 


INCOMPATIBLE OR MISSING NONCRITICAL DS MODULE: 
DS2026CN. (CIWARN 4151) 


DSCOPY, DSTEST, DS2026, OR 


CRITICAL DS MODULES ARE INCOMPATIBLE, NO CONTROL FUNCTIONS EXECUTED. 


(CIERR 4152) 


MISSING CRITICAL DS SOFTWARE, NO CONTROL FUNCTIONS EXECUTED. (CIERR 4153) 


TOO MANY DS USERS ON THIS SYSTEM. CANNOT OBTAIN A VIRTUAL PROCESS NUMBER. 


(CIERR 4154) 


























4155 


4180 


4181 


4182 


4183 
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PROMPT OVERRIDES PREVIOUS PROMPT FUNCTION(S). (CIERR 4155) 

REDUNDANT SPECIFICATION OF CANCEL OPTION IGNORED. (CIWARN 4180) 
CANCEL OPTION HAS NO PARAMETERS. (CIERR 4181) 

DS DEVICE ! IS NOT AN X.21 DEVICE; CANCEL NOT EXECUTED. (CIWARN 4182) 


NO CALL REQUEST FOR DE DEVICE !. (CIWARN 4183) 


RFA ERRORS 


These error messages may returned in the JERR parameter if the condition code = CCE. 


Meaning 
No error. 


The disc is down. 


A file already exists with the specified 
name. 


An attempt was made to backspace a 
device or type 0 file that cannot be 
backspaced. 


An attempt was made to create a type 2 
file with too many records, or the record 
size was too large. 


An attempt was made to read or position a 
record not written; or, on update, to write 
an illegal record length. 


An attempt was made to access a cartridge 
or file that cannot be found, or that has no 
more room. 


An attempt was made to access a file with 
no security or the wrong code. 


An attempt was made to open a file that 
was already opened exclusively, or to open 
eight programs, or the cartridge containing 
the file is locked. 


An attempt was made to position a type 0 
file with DPOSN or to force a type 0 file to 
a type 1. 


Required parameters were omitted from 
the call. 


An attempt was made to access an 
unopened DCB. 


An attempt was made to read, write, or 
position beyond the file boundries. 


Corrective Action 
None. 


Try again and then report it to the 
system manager of the facility. 


Repeat with a new name or purge the 
existing file. 


Check the device type. 


Check the size parameter. 


Check the position or size parameters. 


Check the file name or cartridge 
number. If there is no more room on 
the cartridge, try another or decrease 
the file size. 


Find out the correct code and use it 
or do not access the file. 


Use CL or DL to locate the lock. If 
the file is being packed, check to see 
if the spool is shut down. 


Check the file type. 


Enter the parameters. 


Use CREATE or OPEN to open DCB; 
check for errors. 


Check the record position parameters; 
the result depends on the file type 
and call. 




















The cartridge is locked. 


No more room in the file directory. 


The file name does not conform to the 
syntax rules. 


Wrong type of code supplied; an attempt 
was made to create or purge a type 0 file or 
to create a O-length file. 

An attempt was made to read, write, or 
position a type 0 file that does not support 
the operation. 

The destination node does not have FMP. 


Bad FCODE. Internal RFAM error. 


Incorrect entry number in RFAM. DCB 
destroyed. 


There isn’t any internal table space in 
RFAM. 


Internal RFAM tables are invalid. 
Illegal record size. 
System table error. 


Illegal or missing parameters. 


RFA ERRORS 


Initialize the cartridge if it is not 


Error 
Code Meaning Corrective Action 


currently initialized; otherwise keep 


trying. 


Purge the files and pack the directory 
if possible, or try another cartridge. 


Make corrections to the name. 


Check the size and type parameters. 


Check the file parameters, from 
FMGR check the name. 





RFA ERRORS 


These error messages may be returned in the JERR parameter if the condition code = CCL, otherwise the 
error code is a DSN/DS/ 3000 subsystem error or an MPE file system error. on 


Error 

Code Meaning 
3 
5 





Not enough parameters. 






Parameter address violation 
at the HP 3000. 









Invalid DS line. 





















DEXEC ERRORS 


If the condition code = CCG, these four-character ASCII codes are returned in a double word ABREG. 


Error 
Code 


Illegal record size. 

Illegal request. 

System table error. 

Illegal or missing parameters. 
Illegal or missing parameters. 
Illegal logical unit. 

Logical unit not assigned. 
Illegal user buffer. 


Call rejected by the driver. 


LU not available to user’s session. 


Missing parameter. 
Illegal parameter. 
Program cannot be scheduled. 


Program cannot be defined. 


There is no resolution in the DEXEC TIME call. 





DEXEC ERRORS 


If the condition code = CCL, then a double word ABREG may be one of these binary values, otherwise the 
error code is a DSN/DS/ 3000 subsystem error or an MPE file system error. 


Error Meaning 
Code 

3 

5 








Not enough parameters. 






Parameter address violation 
at the HP 3000. 





Invalid DS line. 





If condition code = CCE the DEXEC call completed satisfactorily. 


























DSCONTROL CONSOLE COMMAND 





APPENDIX 


Before establishing a DSN/DS communications link, the console :DSCONTROL command must be used to 
OPEN a line so that it is available to DSN/DS users. The :DSCONTROL command allows you to enable or 
disable the DSN/DS subsystem on a specific communications link. 


For easy reference, this command is shown in the following format: 


SYNTAX 


PARAMETERS 


OPERATION 


EXAMPLES 


Shows the format of the command. 
Describes the variables in the command. 
Describes the command in detail. 


Shows the command in use. 
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Syntax 


:DSCONTROL dsdevice [;function [;... function] ] 





where the parameter, funct 


sOPEN | ,M 
sSHUT [,S 


_fp 
sRETRY={ 


Parameters 


dsdevice 


OPEN 


SHUT 


B-2 


; TRACE b OF 


zon, has the following meanings: 


ASTER a 
LAVE E [SPEED=] speed | | 


stese eangne sommes pevens Plata 


ON [ALL] [mask] [;numentries] [WRAP] [ filename] | 
F 


weer 


: MON ,DS 
sMONOFF | ,CS 


EF AULT 
ount 


Required parameter. The logical device number or the device class name 
of the DSN/DS communications device (IODSO or IODSX). On your 
system’s I/O configuration listing, the device is back referenced by a pound 
sign (#) to a previously defined INP, HSI, or SSLC. 


For bisync DSN/DS (IODSO), the DS subsystem is enabled but no activity is 
initiated on the communications link. For DS/X.25 (IODSX), the DS 
subsystem establishes a communications link with the PDN. Makes the 
line available for remote communication via the DSN/DS Subsystem. 


Initiates an orderly line shutdown. Refer to OPERATION for details 
about the line closing procedure. 


i 


MASTER 





SLAVE 


Linespeed 











TRACE ,ON 


ALL 


mask 
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Limits DSN/DS line activity to outgoing requests only. No incoming 
sessions are allowed. 


Limits DSN/DS line activity to incoming requests only; no outgoing 
activity is allowed. 


Default: Both MASTER and SLAVE processing are allowed. 


Transmission rate in characters per second (Bit Rate/8). This parameter is 
effective only if your system configuration for the line selected 
SPEED CHANGEABLE. Specify linespeed if yours is a European 
installation with modems running at half speed, or if the line is hardwired 
and you want to override the configured default. It may be necessary to 
include this parameter if the length of cables used for HSI communications 
has been changed since the system was configured. 


HSI speed: 250 000 (cable lengths less than 1000 ft.) 


125 000 (cable lengths greater than 1000 ft.) 


INP or SSLC speed: 250, 300, 600, or 1200 

INP only speed: 2400 (RS232) or 7000 (direct connect on V. 35) 

The SPEED= keyword in the OPEN option may be omitted from a 
sDSCONTROL command. For example, the following two commands have 
exactly the same effect: 

:DSCONTROL 60;OPEN ,MASTER,SPEED=250000 

sDSCONTROL 60;OPEN,MASTER, 250000 

Remember, both ends of the line must operate at the same speed. 

Default: System configuration values. 

Activates the TRACE facility to provide a record of communications 
activities. Trace parameters are positional. The line must already be open, 
or the OPEN keyword must also be included (to open the line). 

Generates trace records for all line activity. 

Default: Records are written only for transmission errors. 

An octal number preceded by a percent sign (%nn). Used to select type of 
trace entries generated. Refer to Sections 3 and 4 in the 


DSN/DS HP 3000 to HP 3000 Network Administrator Manual for an 
explanation of the mask bits. Default: %37 (all except PSTN). 
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numentrtes 


WRAP 


filename 


TRACE , OF F 


MON [ ,DS 
,cS 


MOF F 


Decimal integer for the maximum number of entries in a trace record, not 
greater than 248. 


Default: 24. (See OPERATION.) 


NOTE 


When using DSN/X. 25, there is not enough space left on the INP to trace 
using the default number of entries, 24. The user must specify 
numentries = 16. 


Trace entries that overflow the trace record overlay the prior trace record 
entries. 


Default: Overflow entries are discarded. 


A name for the trace file. 
Default: DSTRCxxx.PUB.SYS (where xxx is the LDEV of the dsdevice). 


Deactivates the TRACE facility, so that no records are kept of DSN/DS 
actions, states, and events. Also closes the trace file. 


Activates internal communication monitoring activity to give additional 
information on a subsequent cold dump of the system. The line must be 
open for the use of MON. 


MON Requests monitoring of all levels of activity. 


MON ,DS Requests monitoring at the DSN/DS level of internal 
software operation. 


MON ,CS Requests monitoring at the Communication System level of 
internal software operation. 


Default: No monitoring. 
Used only for system troubleshooting. 


Deactivates internal DSN/DS monitor records. Line must be open for the 
use of MOFF. 








a 
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RETRY=| DEFAULT Changes the communications error retry count to the specified value. The 
count retry counter controls the number of times the system attempts to send or 
receive a message across the communications link. 


DEFAULT Specifies a limit of 15 retries after a line error occurs. 
count Can be any value within the range of 0 to 255. 


Default: 15. 


Operation 


Unless :DSCONTROL is issued from the master console, this command requires the user to have CS and ND 
capability. In addition, all users except the console operator are granted access to :DSCONTROL only if 
they are ALLOWed to use the command and are ASSOCIATEd with the specified DS device. 


Only one DSN/DS communications device can be active (OPEN) on a controller at any given time. Once 
opened (with the :DSCONTROL command), a communications link can be shared by multiple DSN/DS 
users. It cannot, however, be shared by users of other communications subsystems supported by your 
system (for example, DSN/MRJE). Thus, you must SHUT the DSN/DS communications device before the 
controller can be opened for use by another subsystem. 


Before issuing a :DSCONTROL command, use the :SHOWDEV command to check whether a communications 
link is already established. The LDEV for the INP, SSLC, or HSI port will be UNAVAILable if the 
communications link is in use by any subsystem; the LDEV for a DSN/DS communication device, driver 
IODSO or IODSX, will be AVAILable if it is currently OPEN for use by DSN/DS users. 


If a DS device class includes more than one DS device, the functions specified in the :DSCONTROL 
command apply to all devices in that class. 


If you include more than one function in a :DSCONTROL command, each function (with its subparameter 
list) must be separated by a semicolon. A function that duplicates or conflicts with a previous function 
overrides that function. Functions can appear in any order but are executed in the following order: 

1. OPEN/SHUT 

2. TRACE 

3. MON/MOFF 

The default name of the trace file 1s: 

DSTRCxxx.PUB.SYS 

where xxx is the logical device number of the dsdevice. 

If no trace file exists when you turn on the trace facility and you do not specify numentries, the system 


creates a file to hold 24 entries in each record. If you are using DSN/X.25, however, you must specify 
numentries =16, because there is not enough space on the INP for 24. 
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When using the bisync protocol, the SHUT parameter initiates an orderly line closing procedure. If no 
sessions or applications are using the line when you shut it, line disconnection occurs immediately. If any 
user (including applications) has the line open, the line remains connected until all sessions and 
applications CLOSE the line, or until those accessing the line terminate or are aborted. Once SHUT by the 
console operator, no new users may access the line until the operator reopens it. When using the X.25 
capability of DSN/DS, the SHUT parameter disconnects the line immediately, even if there are current 


users on the line. 
NOTE 


Occasionally you may not be able to SHUT a standard (non-X. 25) DS line. 
This could happen, for example, if a DS user forgot to issue a 
sDSLINE xxx;CLOSE command but still has a local session. It could also 
happen if a remote session is "hung." In such a situation, you can "kill" all 
activity across the line by issuing an :ABORTIO xxx (where xxx is the 
logical device number of the dsdevice). Following the use of the 
:ABORTIO xxx command, a second :DSCONTROL xxx;SHUT command will 
complete successfully. 


B-6 
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Examples 


To open X. 25 line number 55, thereby making it available for use by DSN/DS users, enter: 


:DSCONTROL 55;OPEN 


To permit the local HP 3000 to process only master (outgoing) requests on DS line number 55, enter: 


:DSCONTROL 55;O0PEN ,MASTER 





To activate the CS Trace facility for DS line 55 (the line is already open), enter: 


sDSCONTROL 553; TRACE ,ON,ALL 


To open X.25 line 55 and activate CS Trace with a maximum of 250 entries in a trace record, enter: 


:DSCONTROL 55;OPEN;TRACE,ON,,,250 





To open the line named REMSYS and enable internal monitoring, enter: 


:DSCONTROL REMSYS; OPEN ;MON 























APPENDIX 


TROUBLESHOOTING 





off 


This appendix provides a brief discussion on troubleshooting should a failure occur during HP 3000 to 
HP 1000 communications. Your primary source of information during the troubleshooting process will be 
the DS/1000-IV Network Manager's Manual, the DSN/DS HP 3000 to HP 3000 User/Programmer 
Reference Manual, and the DSN/DS HP 3000 to HP 3000 Network Administrator Manual. These three 
manuals contain discussions specific to the individual systems for tracing and troubleshooting. 


In order to obtain meaningful troubleshooting information, both the sending and receiving ends must be 
traced. This allows you or an HP Systems Engineer (SE) to compare the message formats from both ends 
to ensure that the message was not altered during transmission of the message. The DSN/DS HP 3000 to 
HP 3000 Network Administrator Manual and the DS/1000-IV Network Manager's Manual contain 
diagrams of the message formats. 


HP 3000 TROUBLESHOOTING AND TRACING 


The DSLIST program is used to obtain a list of the software module version numbers for the DSN/DS, 
DSN/X.25, and CS modules installed on your system. This list is required for all troubleshooting 
activities and must accompany each Service Request (SR) that you submit to your HP Systems Engineer 
(SE). 


In order to obtain the list, you must have READ access to the DSN/DS program files in PUB.SYS. The 
command syntax 1s: 


:RUN DSLIST.PUB.SYS 


DSTEST is a systems verification test used to check both the system software and the physical link 
between the computer systems. This test is accomplished by transmitting sample messages across the line 
using Remote File Access (RFA) or PTOP. With DSTEST you can select the number of passes, the word 
pattern to be transmitted, the mode of transmission, and the block size. See the DSN/DS HP 3000 to 
HP 3000 User/Programmer Manual for a more detailed discussion of DSTEST. 


To perform DSTEST you must have established a link to a remote HP 1000 
system using the :DSLINE command. In addition, when using RFA, the 
Remote File Access Monitor (RFAM) must have been scheduled by DINIT, 
the DS initialization program on the HP 1000. When using PTOP, the 
PTOP communication slave monitor (PTOPM) must be running and the 
slave program, DSTES (DSTEST is the master on the 3000), must be RP’d. 


Troubleshooting 


The DSTEST program may be executed in two modes. To execute DSTEST in diagnostic mode, enter the 


following command: 


‘RUN DSTEST.PUB.SYS,DIAG 


Then respond to the questions as follows: 


~-RFA or PTOP? 


»~REMOTE COMPUTER? 


»DSLINE? 


~1000 FILE NAME? 


~NUMBER OF PASSES? 


PATTERN? 


~BLOCK SIZE? 


.CONTINUE (Y/N)? 


Enter RFA for Remote File Access when testing the HP 1000 link. PTOP 
capability is supported to the HP 1000 if the slave (DSTES) is loaded there 
and PTOPM, the HP 1000 program-to-program slave monitor, was 
scheduled by DINIT. 


Enter 1000 (this question is only asked for RFA). 


Enter the device class or logical device number of the DS line to be 
tested. 


Enter a file name of six or fewer characters, beginning with an alphabetic 
character. The file will be purged upon completion of DSTEST, assuming 
that the test was completed successfully (only asked for RFA). 


Enter the number of passes desired, up to a maximum of 32767. A zero 
or a Carriage return causes a default value of one pass to be used. 


Enter an octal word to be transferred. The percent sign indicating octal 
(%) must be entered. An illegal input causes the message, INPUT ERROR, 
to be printed. Enter a correct value or a carriage return to indicate a 
default value, which is 177777. 


Enter the desired block size of the transfer. For the HP 1000 the block 
size must be less than 512 words. If a value greater than 512 is entered, 
an error message is printed. 


Enter a Y to select another set of options, or N to terminate the test. 


A second mode available for DSTEST is called the default mode. To initiate DSTEST in the default mode, 


enter the following: 


sRUN DSTEST.PUB.SYS 


You will then be prompted to enter the DS line you wish to test. DSTEST will then be initiated using one 
pass of PTOP and a 512 word buffer of all %177777's. 


DSTEST Examples 


DSTEST for PTOP 


;DSLINE 141 


DS LINE NUMBER = #L3 


>RUN DSTEST.PUB.SYS,DIAG 














Troubleshooting 


HEWLETT PACKARD 32190A.04.04 DSTEST/3000 WED, SEP 7, 1983, 3:07 PM 
.RFA OR PTOP? PTOP 

.DSLINE? 141 

.NUMBER OF PASSES? 1 

.PATTERN? %1 

.BLOCK SIZE? 128 

128 WORD PROG TO PROG WRITES DONE: 1 ,SECS: 2.130 ,AVE: 2.130 
.CONTINUE (Y/N)? N 


END OF PROGRAM 


DSTEST for RFA 


:DSLINE 141 
DS LINE NUMBER = #L3. 
:RUN DSTEST.PUB.SYS,DIAG 


HEWLETT PACKARD 32190A.04.04 DSTEST/3000 WED, SEP 7, 1983, 3:12 PM 
.RFA OR PTOP? RFA 

.REMOTE COMPUTER? 1000 

.DSLINE? 141 

.1000 FILE NAME? TEMPO1 

.NUMBER OF PASSES? 22 

.PATTERN? %11 

.BLOCK SIZE? 256 

256 WORD REMOTE RECS WRITTEN/READ: 22 ,SECS: 42.012 ,AVE: 1.909 
.CONTINUE (Y/N)? N 


END OF PROGRAM 


¢ 


TRACING FACILITY. The CS/3000 Trace Facility available on the HP 3000 provides a record of the 
line actions, CS states, and events that occur during DSN/DS operations between computer systems. 


This trace facility is invoked by the operator with a :DSCONTROL command when OPENing the 
communications line, or after the OPEN when the line is active. The CS/3000 Trace Facility will record 
the line activity for a particular communications line until either DSN/DS terminates or the operator 
issues a new ;:DSCONTROL command with the TRACE,OFF parameter. 


See the DSN/DS HP 3000 to HP 3000 Network Administrator Manual for specific instructions to invoke 
the CS/3000 Trace Facility. 


TRACE FORMATTING. Once the line activity has been recorded using the CS/3000 Trace Facility, the 


data may be formatted for easier interpretation. There are two formatting programs for DS. They are 
CSDUMP and DSDUMP. 


Troubleshooting 


CSDUMP does some formatting and displays ail trace file data in raw form. DSDUMP allows you to 
choose a subset of the trace file to be formatted, and will also analyze the chosen data. In addition, 
CSDUMP will display all of the bisynchronous line protocol, while DSDUMP only displays the DS 
protocol. 

See the DSN/DS HP 3000 to HP 3000 Network Administrator Manual for specifics to use CSDUMP and 
DSDUMP. 

HP 1000 TROUBLESHOOTING AND TRACING 


There are two utility programs which should be run at the HP 1000 end to record, format, and analyze 
traffic sent over the HP 3000 to HP 1000 PSI and HSI communications link. 


TRACING FACILITIES. LOG3K is a program which initializes logging and is run interactively to 
determine which device or spoolfile the HP 1000 to HP 3000 messages are to be logged. LOG3K is also 
used to determine what information is to be logged. 


Low Level Tracing For HSI. The Synchronous Line Control Information (SLCIN) program tracks all 
driver activity (DV667) on the HSI card. Long term statistics and single events are listed. To use this 
program successfully, you need to have a strong understanding of bisync protocol. 


TRACE FORMATTING. TRC3K is the utility program for the HP 1000 which allows you to examine 
the messages logged by LOG3K. These messages are formatted into readable form by TRC3K. TRC3K 1s 
similar in function to DSDUMP on the HP 3000 side with respect to its formatting function. 


Refer to the DS/1000-IV Network Manager's Manual for a complete discussion of the use of these 
programs. 


Additional HP 1000 Troubleshooting Utilities 


In addition to the previously discussed tracing and formatting utilities, DS/1000-IV provides two other 
utilities that you may find useful for network maintenance. These utilities are DSINF and DSMOD. 


DSINF allows you to examine: 
e The Available Memory Suspend list 
e I/Oclasses in use 


e DS Values, including Resource Numbers, Class Numbers assigned to DS programs, and time-out 
values 


e The Transaction Control Blocks in the DS SAM block 
e DS Lists 


e Network Routing Vector Specifications 





Troubleshooting 


DS Equipment Table entries 





Synchronous Link Control (DVG67) long term statistics 


Message Accounting Values 

e Rerouting Values 

e Remote Sessions active at this node 
Once your node has been initialized, you may schedule DSMOD to make adjustments to parameters set 
during initialization. DSMOD allows you to change the HP 3000 ID sequence, re-enable a link, display 
the NRV, change the non-session password, quiesce the node, schedule additional monitors, adjust timing, 


change the default session user name, and change the Nodal Routing Vector. 


Refer to the DS/1000-IV Network Manager's Manual, Vol I and II, for details on both DSINF and 
DSMOD. 


























APPLICATIONS 





APPENDIX 





This section contains information regarding applications on the DS 3000 to 1000 communications link. It 
provides various DS 3000 to 1000 specifications. 


Line Buffer Configuration Limits 


SOFTWARE 


HP 3000 


HP 1000 


HARDWARE 


HP 3000 


HP 1000 


256 - 4095 words 
The software is loaded using one of the 3 available Libraries. 


304 words maximum 
1072 words maximum 
4096 words maximum 


NOTE 


Continuation records will be used when the 
actual transmitted data exceeds the line 
buffer size. 


The entire transfer includes user’s data, plus the DS fixed part of the 
message format, plus an optional appendage. 


INP 304-1024 words maximum 
HSI 304-4095 words maximum 
SSLC 304-4095 words maximum 


PSI 1072 words maximum 
HSI 4096 words maximum 


Applications 


Opening a Line from the HP 3000 


To open the DS line from the HP 3000 side, a :DSCONTROL x%;OPEN is done from a system console. 
Then, the command :DSLINE zz is done to open a line to the HP 1000. If the HP 1000 is not ready to 
accept a DSLINE, this will fail, and the message REMOTE NOT RESPONDING will appear. At this point the 
HP 1000 operator must be instructed to open the DS line from the HP 1000 side. To close a DS line, the 
command :DSLINE xx;CLOSE isdone. If an attempt at opening a DS line from the HP 3000 side fails, a 
:DSLINE xx;CLOSE must be done before another attempt at opening the line can be accomplished. 


Opening a Line from the HP 1000 


To open a line from the HP 1000 side, type the command :RU,DINIT. DINIT enables the communication 
line interface and schedules the DS monitor and queuing programs that service incoming requests from 
remote network nodes. DINIT schedules QUEX, which is a program used to exchange line open 
information with the HP 3000. After a period of time (if the line fails) QUEX goes into a secondary 
state, and will accept an incoming connection with a HP 3000. The HP 3000 side operator must type in a 
:DSCONTROL xx;OPEN, before a line from the HP 1000 can be opened. To reinstate the HP 1000 side as 
a primary station (allowing you to make the connection from the HP 1000 side), type the command, 
DSMOD/L. 


Session 


Some HP 1000s have the ability to offer users some isolation from other users through a capability called 
SESSION. SESSION provides a unique environment for each user, where capability levels, private disc 
space, device access, etc. can be specified for each logon account. For instance, if a user wishes to access a 
certain file which resides in a private disc area, the user must logon to an account which has access to that 
area of the disc. 


When accessing an HP 1000 (with Session Monitor installed) from an HP 3000, you may wish to make the 
access under a session. This is done transparently to the HP 3000 user by providing a default logon for 
requests received from the HP 3000. The capability level, disc space, device access, etc. is set up for that 
default session by the HP 1000 Network Manager. This default logon is generally given low capabilities 
as a security measure. For most. HP 3000 users, access will be made by interactively (HELLO), or 
programmatically (HELLO command) logging on to a specific account on the HP 1000. The HP 3000 user 
then has the capabilities of that specific logon. For example, if an HP 3000 user wishes to access data 
stored in a private file on the HP 1000, the user will have to issue a logon to a specific account that has 
access to that file before attempting to access the file with remote file access calls. For more details on 
session versus non-session access, refer to "Opening A Line" in Section 2 of this manual. 


It is important to note that the session established on the HP 1000 is a non-interactive session. There is 
no FMGR associated with the session; so the only commands that can be processed are RTE system level 
commands, and DS level DEXEC, RFA, and PTOP calls. 


Running FMGR on the HP 1000 


The only method for issuing remote FMGR commands on the HP 1000 is to place a FMGR transfer file 
on the HP 1000 and then issue the command REMOTE RU,FMGR,trfile. FMGR will run on the 
HP 1000, open the transfer file and execute the commands that it contains. The output of the FMGR 
will go to the system console of the HP 1000. 











Applications 





The request to RU,FMGR causes the actual FMGR program to run (not a 
copy of it). This will tie up FMGR until the transfer file has completed, 
and keep other users on the HP 1000 from logging on (they will not be able 
to get a copy of FMGR for their session). You must also be very careful to 
EX,SP from FMGR at the end of the transfer file or FMGR will be tied up 
to your session until you terminate it (BYE), or it times out. Exercise 
caution when running FMGR from the HP 3000. 


The MOve Command 


DS/1000-IV provides the ability to move files between HP 1000s and HP 3000s with a simple user 
command from RMOTE (the user interface program to the HP 3000). This capability requires 
master-slave software to be installed in both computers. The relocatable “ZRMOTEI1 is a version of 
RMOTE that utilizes a slave program, called COPY3K.PUB.SYS on the HP 3000 to transfer files. The file 
transfer is accomplished with the RMOTE MO command. Refer to the RMOTE section of the 
DS/1000-IV User's Manual for more information. 


NOTE 


COPY3K must exist on the HP 3000 to use the RMOTE MO command. The 
DS/1000-IV Network Manager's Manual, Vol. I, contains installation 
instructions. 








PTOP Testing Using DSTEST 


DS/1000-IV provides a slave program, DSTES (%DSTES), which can be loaded on the HP 1000 for 
verification of the DS PTOP software. Load DSTES, and be sure that it is RPed (given an ID segment). 
From the HP 3000, open the DS line to the HP 1000 and run DSTEST for verification of the PTOP 
software. See Appendix C in this manual for more information. 
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CONFIGURATION DIALOGUE 





ni 


DSN/DS operation requires the installation and configuration of one communications interface for each 
line to a remote computer. 


This section explains how to configure the following: 


NOTE 


Intelligent Network Processor (INP) 

Synchronous Single-Line Controller (SSLC) 

Hardwired Serial Interface (HSI) 

DS Line Monitor (communications driver IODSO or IODSX) 


DS Virtual Terminals (IODSTRMO, IODSTRMX) -- one for each session 
that will be allowed on your system from a remote system. 


The same communications interface (INP, SSLC, or HSI) can be used by another HP 3000 data 
communications subsystem (such as DSN/MRJE) when it is not being used by DSN/DS. In such a case, the 
communications interface is configured once for each subsystem (each time with a unique logical device 
number, but always with the same DRT number). Keep in mind that the following dialogue applies only 
when the interface is used for DSN/DS activity, and that a response that is optional for DSN/DS may not 
be optional for one of the other subsystems. Configuration guidelines pertaining to the other subsystems 
are given in the reference manual for each subsystem. Configuration summary tables for each of the 
communications interface types are included in the Data Communications Handbook and in the HP 3000 
Computer Systems, System Manager/System Supervisor Reference Manual (HP 3000 Computer Systems, 
MPE V System Operation and Resource Management Reference Manual, if you are using MPE V/E). 


For any data communications subsystem to function, CS/3000 modules must be present on the system. It 
is presumed in this configuration description that the HP Systems Engineer (SE) has already installed 
CS/3000. 


If you are making any other changes to the MPE I/O system, refer to the System Manager/System 
Supervisor Reference Manual (HP 3000 Computer Systems, MPE V System Operation and Resource 
Management Reference Manual, if you are using MPE V/E). 


Configuration is accomplished through an interactive dialogue between you and the computer system. As 
the questions or prompts appear on your console, enter the appropriate replies through the console 
keyboard for your desired system configuration. 


Configuration Dialog 


NOTE 


In all responses, Y or N can be used for YES or NO. A is equivalent 
to NO. 


e 








Configuration Dialog 


Prior to entering the dialogue, log onto the system and input a file reference to a magnetic tape, as 
follows: 


sFILE name;DEV=TAPE 
:SYSDUMP *name 


The dialogue commences as follows: 


STEP NO. DIALOGUE 


1 ANY CHANGES? YES 

2 SYSTEM ID = HP 32002 v.uu.ff? 
3 MEMORY SIZE= xxx? 

4 1/O CONFIGURATION CHANGES? YES 

5 LIST I/O DEVICES? YES 


All I/O devices currently configured on the system are listed with the following 
column headings: 











LOG DEV Logical device number. 

DRT # Hardware device address (Device Reference Table 
number) configured on the interface board. 

UNIT # Hardware unit number of device on its controller. 

CHAN Channel number of device on its controller. 

TYPE Device type. 

SUBTYPE Device subtype. 

TERM TYPE Terminal type. 

TERM SPEED Terminal speed. 

REC WIDTH Record width in decimal words. 

OUTPUT DEV Device class name or device Idn. 

MODE J = Accept jobs 


DRIVER NAME 


DEVICE CLASSES 


A= Accept data 

I = Interactive device 
D = Duplicative device 
S = Spooled device 


Driver name. 


Class name assigned to the interface. 


Configuration Dialog 


NOTE 


The prompt in Step 6, below, appears only if a communications subsystem 
(CS) device was previously configured into the system. 

STEP NO. DIALOGUE 

6 LIST CS DEVICES? YES 


A list of all CS devices currently assigned to the system is printed with the 
following column headings: 


LDN Logical device number. 

PM Port Mask. (Not used by INP and SSLC) 
PRT Protocol. 

LCL MOD Local mode. 

TC Transmission code. 

RCV TMOUT Receive timeout (in seconds). 

CON TMOUT Connect timeout (in seconds). 

MODE O= Dial out. 


TRANSMIT SPEED 


T™ 


BUFFER SIZE 


DC 


DRIVER OPTION 


I = Manual answer. 

A= Automatic answer. 

D = Dual speed. 

H = Half speed. 

C = Speed changeable. 

Transmission speed (characters per second.) 
Transmission mode. 

Default buffer capacity, in words. 


Driver changeable or not changeable. 


Driver options. 


Configuration Dialog 


STEP NO. DIALOGUE 


a 


If you have a switched device, such as those that are connected through a dial-up 
telephone line, then you receive the following additional information: 


LDN INP or SSLC logical device number. 
CTRL LEN Not currently implemented. 


PHONE NUMBER LIST A single telephone number -- the default for the 
data communications line. 


LOCAL ID SEQUENCE The default identification of the local computer. 
REMOTE ID SEQUENCE The default identification of the remote computer. 


7 HIGHEST DRT=xx? 





In the output, xx is a value denoting the present highest DRT entry number 
that can be assigned to a device. 


To change xx, enter the new value desired. If the highest-numbered device 
in the configuration is a device that uses more than one DRT entry (such as a 
terminal controller with one or two data set controllers), be sure to enter the 
highest of the DRT numbers. 


~~ To maintain the current xx, enter (RETURN). 


8 LOGICAL DEVICE #? 


To specify a device to be added or removed, enter the logical device number of 
that device. An HSI has four ports and thus can be configured up to four 
times with a unique logical device number for each port. In addition, a 
communications driver (IODSO) with a unique logical device number must be 
configured for each HSI port configured. 





This prompt is repeated later in the configuration dialogue, so that you can 
return to this point to configure more than one device. 


Entering 0 or will take you to Step 47. 
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Configuration Dialog 


STEP NO. DIALOGUE 





9 DRT #? 


To add a device, enter its DRT entry number. For a communications driver 
and a virtual terminal, you must assign the logical device number of the 
associated communications interface (INP, SSLC, or the HSI port), preceded by 
a number sign (#). 


Virtual terminals need to be configured for only one port of any HSI (back 
referenced to only one logical device number for the HSI). The terminals will 
be dynamically allocated to the proper port when a user opens it. 


To remove a device and return to Step 8, enter zero. 


10 UNIT #70 
11 SOFTWARE CHANNEL #? 0 } 
12 TYPE? 


Enter the device type, where 
16 = Virtual Terminals (IODSTRMO or IODSTRMX) 
17 = Intelligent Network Processor (INP) — 
18 = Synchronous Single-Line Controller (SSLC) 
19 = Hardwired Serial Interface (HSI) 


41 = Communications Driver (IODSO or IODSX) 


~ 


When configuring device type 16, consider the maximum number of 
terminals supported by your system. Each virtual terminal configured is 
added to the total number of terminals already on the system. This 
information is available from your HP Sales Representative. 




















Configuration Dialog 


STEP NO. DIALOGUE 
13 SUBTYPE? 


Communications Interface: 
For an INP, enter 0, 1, or 3 
For an SSLC, enter 0 or 1 
For an HSI, enter 3, where 
0 = switched line with modem 
1 = nonswitched line with modem or modem eliminator cable 
3 = hardwired line, synchronous transmission 


Communications Driver: 
For IODSO or IODSX, enter 0 or 1, where 
O = no data compression 
1 = data compression 


Virtual Terminal: 
For IODSTRMO or IODSTRMxX, always enter 8. 8 is 
only used for HP 3000 to HP 1000 communications. 


NOTE 


If you are configuring a terminal (type 16), the dialogue continues to Step 
14. If you are configuring an HSI (Type 19), the dialogue skips to Step 16. 
If you are configuring an SSLC (Type 18), the dialogue skips to Step 17. If 
you are configuring an INP (type 17), the dialogue skips to Step 20. For all 
other device types, the dialogue skips to Step 34. 

14 For MPE V/E: 
ENTER [TERM TYPE #], [DESCRIPTOR FILENAME] ? 


This question is asked only if the device type is 16, or if it is 32 with a 
subtype of 14 0r 15. Term type is always 0 for DSN/DS Virtual Terminals. 


For MPE IV: 
TERM TYPE? O 


This question is asked only if Type is 1 6. Term Type is always zero for 
DSN/DS Virtual Terminals. 


13 SPEED IN CHARACTERS PER SECOND? 0 


This question is asked only if device Type is 16, then the dialogue skips to Step 
34. 


Configuration Dialog 


STEP NO. DIALOGUE 


16 PORTMASK? 


This question is asked only if device Type is 19 (HSI). The values allowable 
are shown below and must be entered in decimal. This forms a mask 
indicating which HSI channel will be used. Only one of the four channels 
may be designated for each unique logical device number. 


Enter 8 for HSI cable connector port 0. 
Enter 4 for HSI cable connector port 1. 
Enter 2 for HSI cable connector port 2. 
Enter 1 for HSI cable connector port 3. 
Since only one port on the HSI PCA can be opened at a time, only one block of 
virtual terminals (entered Jater in this configuration) are needed for that HSI 


PCA. This same block is automatically reallocated to each new port opened. 
One block of virtual terminals serves all ports. 


17 PROTOCOL? 1 


This response defines Binary Synchronous Communications. 


18 LOCAL MODE? 


DSN/DS/3000 does not use this response. Enter 1. 


Configuration Dialog 


STEP NO. DIALOGUE 





19 TRANSMISSION CODE? 
For an HSI, enter 1. 


For an SSLC, enter 1, 2, or 3, where 

1 = Automatic code sensing of ASCII and EBCDIC if 
initially receiving, ASCII if initially sending; 

2 = ASCII transmission. 

3 = EBCDIC transmission. 


In DSN/DS, all transmissions are ASCII. Only in certain other data 
communication subsystems can users optionally transfer EBCDIC characters. 


20 RECEIVE TIMEOUT? 


Enter the positive number of seconds the CS device will wait to receive text 
before terminating the read mode. Entering provides a 20-second 
timeout. 





NOTE 


For all timeout responses, entering 0 disables the timeout. The maximum 
timeout is 32000 seconds. DS displays an error when the communications 
software (CS) disconnects because of a timeout. 





21 LOCAL TIMEOUT? 


Enter the positive number of seconds a connected local station will wait to 
transmit or receive before disconnecting. Entering provides a 
60-second timeout. (Your response is not used for DSN/DS activity. ) 


22 CONNECT TIMEOUT? 





Enter the positive number of seconds the local station will wait after one 
attempt to make a connection to a remote station. Entering provides 
a 900-second timeout. For an HSI, 100 to 500 is recommended. For an INP 
or SSLC, 300 is recommended. 


NOTE 


Steps 23 through 25 apply only to CS devices with switched lines connected 
through a modem (dial telephones, subtype 0). For CS devices with 
nonswitched lines connected through a modem (private lines, subtype 1), the 
dialogue skips to Step 26. If the CS device is either an HSI or a hardwired 
INP (subtype 3), the dialogue skips to Step 28. 





Configuration Dialog 


STEP NO. 


23 


24 


25 


26 


27 


28 


DIALOGUE 
DIAL FACILITY? 


Enter YES if manual dial-up is required. Enter the INP LDEV# if the 
AUTO DIAL feature is used. Enter NO if no dial facility is required. 


ANSWER FACILITY? 


Enter YES if the local modem can answer calls, either manually or 
automatically. Enter NO if it cannot. A NO response causes the next step to 
be skipped. 


AUTOMATIC ANSWER? 


Enter YES if the local modem can automatically answer calls. Enter NO if 
manual answering is required. 


DUAL SPEED? 


Enter YES if the local modem is dual speed (European models). Enter NO if it 
is single speed. A NO response causes the next step to be skipped. 


HALF SPEED? 


Enter YES if the local modem is to operate at half speed. Enter NOif it is to 
operate at full speed. The dialogue skips to Step 29. 


SPEED CHANGEABLE? 
For an HSI, enter YES. 


For an INP, enter YES if the speed of the line is changeable. Enter NO if the 
line speed is fixed. In general, the speed is changeable when the 
communications interface provides the clocking, and it is not changeable 
when a single-speed modem or other external device provides the clocking. 
You must respond YES if the console operator will be using the speed 
parameter in the :DSCONTROL command to override the configured 
transmission speed (see Step 29). 


Configuration Dialog 


STEP NO. DIALOGUE 
29 TRANSMISSION SPEED? 


For INP (Type 17) or SSLC (Type 18) devices, enter the transmission speed of 
the line in characters per second (Bit Rate/&). For HSI (Type 19) devices, 
enter 250000 for cable lengths up to 1000 feet, or enter 125000 for cable 
lengths greater than 1000 feet. 


The transmission speed you specify is ignored for modems that provide 
internal clocking signals. This allows modems of different speeds to be used 
without reconfiguring the Operating System. The speed specified is used if 
the modems are eliminated and the controllers are hardwired together. 


The speed you specify becomes the default. The console operator can override 
the default by including the speed parameter in the : DSCONTROL command, if 
you answered YES to Step 28. 
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Configuration Dialog 


STEP NO. DIALOGUE 
30 TRANSMISSION MODE? 


Enter the appropriate number for the transmission mode in use. The mode 
numbers are: 


0 = Full duplex 
1 = Half duplex 


INP and SSLC: 
Configure the communications interface (INP or SSLC) to operate in Full 
Duplex (0) if your facility uses one of the following: 
e A leased line with four-wire, point-to-point installation. 
e A dial network with two lines (four-wire equivalent). 
e A dial network with Wide Band Service. 
e Any Direct Connect cable between two INPs. 
Configure the communications interface to operate in Half Duplex (1) if your 
facility uses the following: 
e A dial network with a single-line (two-wire) installation. 
e An INP-to-SSLC Direct Connect cable (a “modem eliminator" cable 
between an INP and an SSLC) 
Your response must agree with the remote system’s configuration and with the 
characteristics of the communications line. 
HSI: 


Always configure an HSI as Full Duplex (0). 




















STEP NO. 


31 


32 


33 


34 


35 


36 


37 


Configuration Dialog 


DIALOGUE 

PREFERRED BUFFER SIZE? 
Enter, in words, the desired buffer size, to a maximum of 4095 words for an 
HSI or SSLC, or up to a maximum of 1024 words for an INP. For a dial-up 
line, 1024 is generally recommended; for a leased line with an SSLC, the size 
may be larger than 1024 if the line quality is good. Note that although large 
buffer sizes increase transmission efficiency, they also use up memory space. 
Match buffer sizes for sender and receiver whenever possible, since the 
effective buffer size that can be utilized is the smaller of the two. 

DRIVER CHANGEABLE? NO 


DRIVER OPTIONS? 0 


NOTE 


The dialogue skips to Step 41. 


RECORD WIDTH? 

For IODSO and IODSX, enter 128. 

For all Virtual Terminals, enter 40. 
OUTPUT DEVICE? 

For the communications drivers, enter 0. 


For a virtual terminal, enter the class name or logical device number to be 
used for the corresponding job/session listing device. 


ACCEPT JOBS/SESSIONS? 
For the communications drivers, enter NO. 
For virtual terminals, enter YES. 


ACCEPT DATA? NO 


Configuration Dialog 


STEP NO. 


38 


39 


40 


41 
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DIALOGUE 
INTERACTIVE? 
For the communications drivers, enter NO. 
For virtual terminals, enter YES. 
DUPLICATIVE? 
For the communications drivers, enter NO. 
For virtual terminals, enter YES. 
INITIALLY SPOOLED? NO 
DRIVER NAME? 
Enter the name of the driver for this device as follows: 
IOINPO =INP 
CSSBSCO =SSLC 
CSHBSCO = HSI 
IODSO = Communications driver, while using the bisync protocol 
IODSX = Communications driver, while utilizing the X.25 capability 
IODSTRMO = Virtual terminals, while using the bisyne protocol 


IODSTRMX = Virtual terminals, while utilizing the X.25 capability 


NOTE 


Steps 42 through 45 apply to CS devices with switched (dial-up) lines (types 
17 and 18, subtype 0). The dialogue for all other devices skips to Step 46. 


























Configuration Dialog 


STEP NO. DIALOGUE 
42 PHONELIST? 
Enter YES or NO. 


You can supply one number (usually a frequently dialed number) which will 
be the system default. 


43 PHONE NUMBER? 
Enter a string of numbers and hyphens, but not more than 30 characters. 
This number will be included in the I/O request on the system console when a 
user OPENs a dial-up line. 
The characters that can be used for the phone number are: 
0 through 9 
/ (separator used for automatic call units that have a second dial tone detect) 


E (optional end-of-number indicator) 


D (one-second delay. Used for European modems and automatic call units 
that require built-in delays) 


# (defined by the local telephone system) 
# (defined by the local telephone system) 
44 LOCAL ID SEQUENCE? 


The default local ID sequence can be specified in ASCII. Enter for a 
null local ID sequence, or enter an ASCII string in quotes. 


NOTE 


Do not enter more than 16 characters for the local or remote ID sequence. 
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Configuration Dialog 


STEP NO. DIALOGUE 
45 REMOTE ID SEQUENCE? 


Enter the default remote ID sequence in the same format as the local ID 
sequence (above). This can be repeated until is entered. 


46 DEVICE CLASSES? 


Enter a list containing a device class name (up to eight alphanumeric 
characters, beginning with a letter). Class names are separated from each 
other by commas. These names are left to the discretion of the System 
Supervisor. They will be used in certain commands and intrinsics when any 
member of a group of devices (such as any disc drive) can be referenced. No 
name need be entered. 


NOTE 


For IODSX entries, the destination logical node name cannot be specified as 
a device class name. 


The dialogue now prints the LOGICAL DEVICE #? prompt described in Step 
8. If all I/O configuration is complete, press and the dialogue 
continues at Step 47. Otherwise, enter a logical device number and repeat the 
configuration procedure from Step 8. 

47 MAX # OF OPENED SPOOLFILES= xxx? 

48 LIST OF I/O DEVICES? YES 


To print a listing of the new input/output device configuration, enter YES. 
This list appears in the format described in Step S. 


NOTE 


Step 49 only appears if you are using MPE V/E. 


49 TERMINAL TYPE CHANGES? 
Enter NO. 
50 LIST CS DEVICES? YES 


Enter YES to list the characteristics of the new CS device configuration. 














STEP NO. 
51 


52 


$3 
54 
55 
56 
$7 
58 
59 
60 
61 


62 


Configuration Dialog 


DIALOGUE 
CLASS CHANGES? 


LIST 1/0 DEVICES? (RETURN) 


NOTE 


The prompt in Step 53 appears only if a CS device is configured or if 
additional drivers exist (for the CS driver-changeable option in Step 32). If 
neither case exists, the dialogue skips to Step 55. 


ADDITIONAL DRIVER CHANGES? NO 
1/O CONFIGURATION CHANGES? NO 
SYSTEM TABLE CHANGES? NO 

MISC CONFIGURATION CHANGES? NO 
LOGGING CHANGES? NO 

DISC ALLOCATION CHANGES? NO 
SCHEDULING CHANGES? NO 

SEGMENT LIMIT CHANGES? NO 
SYSTEM PROGRAM CHANGES? NO 


SYSTEM SL CHANGES? NO 


The NO response assumes CS/3000 modules are already present on the system. 
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Configuration Dialog 


STEP NO. DIALOGUE 
63 ENTER DUMP DATE? 


Copies the modified MPE. When this copy is used to COLDSTART 
the system, the account structure and all files remain intact. 


mm/dd/yy where mm/dd/yy is some date in the future. Copies the modified 
MPE and the current accounting, but no files. 


mm/dd/yy where mm/dd/yy is usually the date of the most recent system 
backup. Copies the modified MPE, the current accounting structure, 
and any files that were changed on or since the specified date. 


0 Copies the entire system (MPE, the current accounting structure, and 
all files). 


64 ENTER DUMP FILE SUBSETS? 


Enter (RETURN), or enter a filename or series of filenames. (Example: 
@.PUB.SYS) 


65 LIST FILES DUMPED? YES or NO 
66 The console operator must now use the =REPLY command to assign the magnetic tape 


drive on which you have arranged for a tape reel to be mounted. 


After the SYSDUMP is complete, the tape produced should be used to COLDSTART the system. During 
COLDSTART, the old I/O device configuration is replaced with the new one from your SYSDUMP tape. 


HP ASCII CHARACTER SET 


First Character Second Character 
Octal Equivalent Octal Equivalent 





ASCII 
Character 
A 
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040400 
041000 
041400 
042000 
042400 
043000 
043400 
044000 
044400 
045000 
045400 
046000 
046400 
047000 
047400 
050000 
050400 
051000 
051400 
052000 
052400 
053000 
053400 
054000 
054400 
055000 




























060400 
061000 
061400 
062000 
062400 
063000 
063400 
064000 
064400 
065000 
065400 
066000 
066400 
067000 
067400 
070000 
070400 
071000 
071400 
072000 
072400 
073000 
073400 
074000 
074400 
075000 


030000 
030400 
031000 
031400 
032000 
032400 
033000 
033400 
034000 
034400 


000000 
000400 
001000 
001400 
002000 
002400 


000101 
000102 
000103 
000104 
000105 
000106 
000107 
000110 
000111 
000112 
000113 
000114 
000115 
000116 
000117 
000120 
000121 
000122 
000123 
000124 
000125 
000126 
000127 
000130 
000131 
000132 


000141 
000142 
000143 
000144 
000145 
000146 
000147 
000150 
000151 
000152 
000153 
000154 
000155 
000156 
000157 
000160 
000161 
000162 
000163 
000164 
000165 
000166 
000167 
000170 
000171 
000172 


000060 
000061 
000062 
000063 
000064 
000065 
000066 
000067 
000070 
000071 


000000 
000001 
000002 
000003 
000004 
000005 













































































































-| Pm OwviA.. 











ASCII First Character 
Character Octal Equivalent 


003000 
003400 
004000 
004400 
005000 
005400 
006000 
006400 
007000 
007400 
010000 
010400 
011000 
011400 
012000 
012400 
013000 
013400 
014000 
014400 
015000 
015400 
016000 
016400 
017000 
017400 
020000 
020400 
021000 
021400 
022000 
022400 
023000 
023400 
024000 
024400 
025000 
025400 
026000 
026400 
027000 
027400 
035000 
035400 
036000 
036400 
037000 
037400 
040000 
055400 
056000 
056400 
057000 
057400 
060000 
075400 
076000 
076400 
077000 
077400 
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Second Character 
Octal Equivalent 


000006 
000007 
000010 
000011 
000012 
000013 
000014 
000015 
000016 
000017 
000020 
000021 
000022 
000023 
000024 
000025 
000026 
000027 
000030 
000031 
000032 
000033 
000034 
000035 
000036 
000037 
000040 
000041 
000042 
000043 
000044 
000045 
000046 
000047 
000050 
000051 
000052 
000053 
000054 
000055 
000056 
000057 
000072 
000073 
000074 
000075 
000076 
000077 
000100 
000133 
000134 
000135 
000136 
000137 
000140 
000173 
0001 74 
000175 
000176 
000177 


Second Character 










































































A 


ACCEPT call, 6-4 

and GET, 6-4 

and PCONTROL, 6-4 

and POPEN, 6-4 

and PREAD, 6-4 

and PWRIT, 6-4 

error conditions, 6-6 

parameters, 6-6 

syntax, 6-4 
Adding a communications driver, E-6 
Adding a device, E-6 
Adding a virtual terminal, E-6 
Adding devices, and maximum number of devices, E-6 
ASCII, E-9 
ASCII and EBCDIC, E-9 








C 


Cable 
Direct Connect, E-12 
modem eliminator, E-12 
Closing a DS line, 1-6, 2-40 
DSLINE parameters, 2-40 
DSLINE syntax, 2-40 
examples, 2-40 
COLDSTART, E-18 
Communications driver, E-14 
adding, E-6 
with X.25, E-14 
Communications Driver, E-6, E~7 
Communications interface, 2-2 
drivers, 2-8 
Hardwired Serial Interface (HSI), 2-2 
Intelligent Network Processor (INP), 2-3 
Programmable Serial Interface (PSI), 2-3 
CS/3000, E-1, E-4 
trace facility for the HP 3000, C-3 
CSDUMFP trace formatting program for the HP 3000, C-4 
CSHBSCO, E-14 
CSSBSCO, E-14 
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Index 


D 


DAPOS call, 5-5 
error condtions, 5-5 
parameters, 5-5 
syntax, 5-5 
DCLOS call, 5-7 
error conditions, 5-7 
parameters, 5-7 
syntax, 5-7 
DCONT call, 5-9 
error conditions, 5-9 
parameters, 5-9 
syntax, 5-9 
DCRET call, 5-10 
error conditions, 5-11 
parameters, 5-10 
syntax, 5-10 
Default speed, overriding, E-1 1 
Device 
adding, E-6 
removing, E-6 
Device Reference Table number, E-3 
Device type, E-3 
Devices 
switched, E-9, E-14 
DEXEC 
capabilities, 4-1 
error checking routine example, 4-4 
error messages, A-13, A-14 
table of calls and their functions, 4-2 
DEXEC call elements, 4-3 
functional return, 4-4 
syntax, 4-3 
DEXEC calls (see individual call index listing also) 
I/O CONTROL, 4-10 
I/O STATUS, 4-16 
program example, 4-17 
PROGRAM SCHEDULE, 4-11 
READ, 4-6 
TIME REQUEST, 4-13 
TIMED PROGRAM SCHEDULE, 4-14 
WRITE, 4-8 
Dial networks 
with four wire equivalent, E-12 
with single-line installation, E-12 
with two lines, E~12 
with two-wire installation, E-12 
with Wide Band Service, E-12 
Dialing the remote computer, 2-20 
default situation, 2-20 
DINIT, D-2 
Direct Connect cable, E-12 
Disabling, timeout, E-9 
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DLOCF call, 5-12 
error conditions, 5-13 
parameters, 5-12 
syntax, 5-12 
DNAME call, 5-14 
error conditions, 5~14 
parameters, 5-14 
syntax, 5-14 
DOPEN call, 5-15 
error conditions, 5-16 
parameters, 5-15 
syntax, 5-15 
DPOSN call, 5-17 
error conditions, 5-17 
parameters, 5-17 
syntax, 5-17 
DPURG call, 5-18 
error condtions, 5-18 
parameters, 5-18 
syntax, 5-18 
DREAD call, 5-19 
error conditions, 5-19 
parameters, 5-19 
syntax, 5-19 
Driver name, E-3 
Drivers, 2-8 
DRT number, E-3, E-5 
DS Line Monitor, E-1 
DSCONTROL 
command execution order, B-5 
error messages, A-6 
examples, B-7 
informatory messages, A-6 
operation, B-5 
parameters, B~-2 
syntax, B-2 
DSDUMF trace formatting program for the HP 3000, C-4 
DSINF, C-4 
DSLINE command, 2-17 
line buffer considerations, 2-3 
line buffer specification, 2-6, 2-18 
parameters for closing a line, 2-40 
parameters for opening a line, 2-17 
specifying ID sequences, 2-20 
syntax errors, A-2 
syntax for closing a line, 2-40 
syntax for opening a line, 2-17 
DSLIST, C-1 
DSMOD, C-4 
DSN/DS capabilities, 1-1 
DSN/DS functional errors, A-3 


Index 


INDEX-3 


Index 


DSTAT call, 5-20 
error conditions, 5-20 
parameters, 5-20 
syntax, 5-20 

DSTEST, C-1, D-3 
default mode, C-2 
diagnostic mode, C-2 
examples, C-2 

Dump date, E-18 

DWIND call, 5-21 
error conditions, 5-21 
parameters, 5-21 
syntax, 5-21 

DWRIT call, 5-22 
error conditions, 5-22 
parameters, 5-22 
syntax, 5-22 


E 


EBCDIC, E-9 
EBCDIC and ASCII, E-9 
Editing HP 1000 files, 3-6 
Error messages 
DEXEC, A-13, A-14 
DSCONTROL, A-6 
DSCONTROL informatory messages, A-6 
DSLINE, A-2 
DSN/DS functional errors, A-3 
RFA, A-10, A-12 
Establishing a communications link, 3-2 
Establishing a remote session, 3-2 
Examples 
closing a DS line, 1-6 
closing a line with DSLINE, 2-40 
DEXEC call error checking routine, 4-4 
DSCONTROL, B-7 
establishing multiple lines (hardwired), 2-30 
establishing multiple lines (telephone lines), 2-34 
exclusive option example, 2-23 
FORTRAN program using RFA calls, 5-26 
HP 1000 master - HP 3000 slave PTOP programs , 6-26 
HP 3000 master - HP 1000 slave PTOP programs, 6-22 
initiating a remote session, 1-3 
issuing a remote RTE command, 1-5 
multiple user (dial-up line), 2-24, 2-26, 2-28 
multiple user (hardwired), 2-22 
opening a DS line, 1-5 
program using DEXEC calls, 4-17 
RFA error checking routine, 5-3 
running DSTEST, C-2 
SPL program using RFA calls, 5-23 
Exclusive line access, 2-21 
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Exclusive option example (hardwired), 2-23 
Executable RTE operator commands, 3-4 
Executable RTE system commands, 3-1 
Executing multiple remote RTE commands, 3-3 
Exiting a remote session, 3-5 


F 


File Management Program (FMGR), 3-6, D-2 
Four-wire, E-12 
Full Duplex, E-12 


G 


GET call, 6-7 
error conditions, 6-9 
functional return, 6-7 
parameters, 6-8 
syntax, 6-7 


H 


Half duplex, E-12 
Hardware and software requirements, 2-1 
Hardware device address, E-3 
Hardwired Serial Interface (HSI), E-1, E-5, E-6, E-7, E-8, E-9, E-10, E-12, E-14 
adding, E-6 
connection, 2-2 
HP 1000 troubleshooting and tracing, C-4 
LOG 3K, C-4 
low level tracing for HSI, C-4 
SLCIN trace facility, C-4 
trace facilities, C-4 
TRC3K, C-4 
HP 3000 to HP 1000 communications 
capabilities, 1-2 
hardware requirements, 2-1 
software requirements, 2-1 
HP 3000 troubleshooting and tracing, C~-1 
DSLIST, C-1 
DSTEST, C-1 
HSI, E~-1, E-5, E-6, E~7, E-8, E-9, E-10, E-12, E-14 
adding, E-6 
connection, 2-2 
hardwired sample I/O device table, 2-8, 2-10 
line buffer configuration limits, D- | 


Index 
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Index 


I/O CONTROL call, 4-10 
error conditions, 4-10 
funtional return, 4-10 
parameters, 4-10 
syntax, 4-10 
I/O device table samples, 2-8, 2-10, 2-12, 2-14 
I/O devices, E-3 
I/O STATUS call, 4-16 
error conditions, 4-16 
parameters, 4-16 
syntax, 4-16 
ID sequence exchange, 2-20 
default, 2-20 
telephone connection, 2-6 
Initiating a remote session, 1-3 
INP, E-1, E-4, E-6, E-7, E-10, E-14 
adding, E-6 
connection, 2-3 
dialup sample I/O device table, 2-14 
hardwired sample I/O device table, 2-10 
line buffer configuration limits, D-1 
telephone connection, 2-5 
INP to PSI 
compared to HSI connection, 2-3 
line buffering, 2-3 
speed capabilities, 2-3 
INP-to-SSLC Direct Connect cable, E-12 
Intelligent Network Processor (INP), E-1, E-4, E-6, E-7, E-10, E-14 
adding, E-6 
connection, 2-3 
Interfaces, and use with other subsystems, E-1 
IODSO, E-1, E-7, E-14 
IODSTRMO, E-1, E-7, E-14 
IODSTRMX, E-1, E-7, E-14 
IODSX, E-1, E-7, E 
IOINPO, E-14 
Issuing local commands, 3-5 
exiting a remote session, 3-5 
Issuing remote RTE commands, 1-5, 3-2 
executable RTE operator commands, 3-4 
using remote subsystem from a batch job, 3-4 


-7, 
-14 


L 


LDEV, E-4 

LDN, E-4 

Leased line, E-12 

Leaving SYSDUMP, E-S, E-16 
Leaving system I/O configuration, E-5 
Leaving system I/O configurator, E-16 
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Index 


Limitations 
editing HP 1000 files interactively, 3-6 
interactive access of RTE subsystems , 3-6 
running the File Management Program (FMGR), 3-6 
Line buffering, 2-3 
configuration limits, D-1 
INP to PSI, 2-3 
telephone connection, 2-6 
Line opening failures, 2-38 
LOG3K trace facility for the HP 1000, C-4 
Logical device number, E-4 





Maximum number of devices, E-6 
Modem eliminator cable, E-12 
Modems, with internal clocking signals, E-11 
MOve command on the HP 1000, D-3 
MPE I/O System, changes to, E-1 
MPE IV, E-7 
MPE V, E-7 
Multiple line examples 
hardwired, 2-30 
telephone lines, 2-34 
Multiple user examples 
dial-up line, 2-24, 2-26, 2-28 
hardwired, 2-22 
Multiple user line access, 2-21 








N 


Non-session access versus session access on the HP 1000, 2-5, 2-7, 3-1 


O 


Opening a DS line, 1-5 

Opening a line, 2-2 
dialing the remote computer, 2-20 
exclusive access, 2-21 
exclusive option example (hardwired) , 2-23 
from the HP 1000, D-2 
from the HP 3000, D-2 
hardwired, 2-2 
ID sequences, 2-20 
line opening failures, 2-38 
multiple line example (hardwired), 2-30 
multiple line example (telephone lines), 2-34 
multiple lines, 2-29 
multiple user example (dial-up line), 2-24, 2-26, 2-28 
multiple user example (hardwired), 2-22 
multiple users, 2-21 
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Index 


specifying a line, 2-7 
telephone connection, 2-5 
X.25 line specification, 2-16 
Opening a telephone line, 2-5 
autodial, 2-7 
communications interface, 2-5 
dialing, 2-6 
ID sequence exchange, 2-6 
INP interface, 2-5 
PSI interface, 2-5 
SSLC interface, 2-5 
Opening multiple DS lines, 2-29, 3-2 
Output dev, E-3 
Overriding default speed, E-11 


Pp 


PCHECK call, 6-10 
error conditions, 6-10 
functional return, 6-10 
parameters, 6-10 
syntax, 6-10 
PCLOSE call, 6-11 
error conditions, 6-11 
parameters, 6-11 
syntax, 6-11 
PCONTROL call, 6-12 
error conditions, 6-12 
parameters, 6-12 
syntax, 6-12 
Performance considerations, PTOP versus RFA, 6-3 
Point-to-point, E-12 
POPEN call, 6-14 
error conditions, 6-15 
functional return, 6-14 
parameters, 6-14 
syntax, 6-14 
PREAD call, 6-17 
error conditions, 6-18 
functional return, 6-17 
syntax, 6-17 
PROGRAM SCHEDULE call, 4-11 
error conditions, 4-12 
functional return, 4-11 
parameters, 4-11 
syntax, 4-11 
Program-To-Program communications, see PTOP 
Programmable Serial Interface, see PSI 
PSI 
hardwired connection, 2-3 
line buffering, 2-3 
line buffering configuration limits, D-1 
speed capabilities, 2-3 
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Index 


telephone connection, 2-5 
PTOP 
buffer size, 6-2 
capabilities, 6-1 
master program calls for the HP 3000 and HP 1000 (table), 6-1 
performance considerations, 6-3 
slave program calls for the HP 3000 and HP 1000 (table), 6-2 
testing using DSTEST, D-3 
PTOP calls (see individual call index listing also) 
ACCEPT, 6-4 
GET, 6-7 
HP 1000 master - HP 3000 slave program examples, 6-26 
HP 3000 master - HP 1000 slave program examples, 6-22 
PCHECK, 6-10 
PCLOSE, 6-11 
PCONTROL, 6-12 
POPEN, 6-14 
PREAD, 6-17 
PWRITE, 6-19 
REJECT, 6-21 
PTOP versus RFA performance considerations, 6-3 
PWRITE call, 6-19 
error conditions, 6-20 
parameters, 6-19 
syntax, 6-19 








R 


READ call, 4-6 
error conditions, 4-7 
functional return, 4-6 
parameters, 4-6 
syntax, 4-6 
Rec width, E-3 
Record width, E-3 
REJECT call, 6-21 
error conditions, 6-21 
parameters, 6-21 
syntax, 6-21 
Remote File Access, see RFA 
Remote session capabilities, 3-1 
Removing a device, E-6 
RFA 
capabilities, 5-1 
description of error conditions and parameters, 5-3 
error checking routine example, 5-3 
error messages, A-10, A-12 
RFA and FMP cross referencing (table), 5-2 
RFA calls (see individual call index listing also) 
DAPOS, 5-5 
DCLOS, 5-7 
DCONT, 5-9 
DCRET, 5-10 
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DLOCF, 5-12 
DNAME, 5-14 
DOPEN, 5-15 
DPOSN, 5-17 
DPURG, 5-18 
DREAD, 5-19 
DSTAT, 5-20 
DWIND, 5-21 
DWRIT, 5-22 
FORTRAN program example, 5-26 
SPL program example, 5-23 
RFA versus PTOP performance considerations, 6-3 
RMOTE, D-3 
RTE subsystems 
interactive access, 3-6 
limitations to interactive access, 3-6 


S 


Sample I/O device tables 
HSI hardwired, 2-8 
INP dialup, 2-14 
INP hardwired, 2-10 
SSLC dialup, 2-12 
Saving SYSDUMP, E-3 
Saving System I/O Configuration, E-3 
Session access versus non-session access on the HP 1000, 2-5, 2-7, 3-1 
Sessions access on the HP 1000, D-2 
SLCIN trace facility (HP 1000), C-4 
Specifying a line, 2-7 
Speed, overriding default, E-11 
SSLC, E-1, E-4, E-6, E-7, E-9, E-14 
adding, E-6 
dialup sample I/O device table, 2-12 
line buffer configuration limits, D-1 
SSLC communications interface, telephone connection, 2-5 
Subsystems, and use with interfaces, E-1 
Subtype, E-3, E-7 
Switched devices, E~9, E-14 
and SYSDUMP, E-5 
and system I/O configuration, E-5 
synchronous Line Control Information, see SLCIN 
Synchronous Single-Line Controller (SSLC), E-1, E-4, E-6, E-7, E-9, E-14 
adding, E-6 
SYSDUMP, E-1 
leaving, E-5, E-16 
saving, E-3 
with switched devices, E-5 
System I/O configuration 
leaving, E-5 
with switched devices, E-5 
System I/O Configuration, E-1 
saving, E-3 
System I/O configurator, leaving, E-16 
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T 


Term speed, E-3 
Terminal speed, E-3 
Terminating a remote session, 3-5 
TIME REQUEST call 
error conditions, 4-13 
parameters, 4-13 
syntax, 4-13 
TIMED PROGRAM SCHEDULE call, 4-14 
error conditions, 4-15 
parameters, 4-14 
syntax, 4-14 
Timeout, disabling, E-9 
Trace formatting for the HP 1000, C-4 
Trace formatting for the HP 3000, C-4 
Tracing facility for the HP 1000, C-4 
Tracing facility for the HP 3000, C-3 
Tracing the HP 1000, see HP 1000 troubleshooting and tracing 
Tracing the HP 3000, see HP 3000 troubleshooting and tracing 
TRC3K for formatting HP 1000 trace data, C-4 
Troubleshooting the HP 1000, see HP 1000 troubleshooting and tracing 
Troubleshooting the HP 3000, see HP 3000 troubleshooting and tracing 
Type, E-6 
Type 16, E-7 
Type 19, E-8 
Type 32, E~7 


U 


Using the remote subsystem from a batch job, 3-4 


V 


Virtual terminal, E-7, E-14 
adding, E-6 
with X.25, E-14 

Virtual terminals, E-1 


W 


Wide Band Service, E-12 
WRITE call, 4-8 
error conditions, 4-9 
functional return, 4-8 
parameters, 4-8 
syntax, 4-8 
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X.25, E-14 
X.25 line specification, 2-16 
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Product Line Sales/Support Key 


Key Product Line 

A Analytical 

CM Components 

C Computer Systems Sales only 

CH Computer Systems Hardware Sales and Services 
CS Computer Systems Software Sales and Services 
E Electronic Instruments & Measurement Systems 














M Medical Products 

MP Medical Products Primary SRO 

MS Medical Products Secondary SRO 

P Personal Computation Products 
Sales only for specific product line 


Support only for specific product line 


IMPORTANT: These symbols designate general product line capability. They do not 
insure sales or support availability for all products within a line, at all locations. 
Contact your local sales office for information regarding locations where HP support 


is available for specific products. 
HP distributors are printed in italics. 


HEADQUARTERS OFFICES 


lf there is no sales office listed for your area, contact one of these 


headquarters offices. 


NORTH/CENTRAL AFRICA 
Hewlett-Packard S.A. 

7, Rue du Bois-du-Lan 

CH-1217 MEYRIN 2, Switzerland 

Tel: (022) 83 12 12 

Telex: 27835 hpse 

Cable: HEWPACKSA Geneve 


ASIA 

Hewlett-Packard Asia Ltd. 

6th Floor, Sun Hung Kai Centre 
30 Harbour Rd. 

G.P.0. Box 795 

HONG KONG 

Tel: 5-832 3211 

After Jan. 1, 1984 

47th Floor, China Resources Bldg. 
26 Harbour Rd., Wanchai 
HONG KONG 

Telex: 66678 HEWPA HX 
Cable: HEWPACK HONG KONG 


CANADA 

Hewlett-Packard (Canada) Ltd. 
6877 Goreway Drive 
MISSISSAUGA, Ontario L4V 1M8 
Tel: (416) 678-9430 

Telex: 610-492-4246 


EASTERN EUROPE 
Hewlett-Packard Ges.m.b.h. 
Lieblgasse 1 

P.0.Box 72 

A-1222 VIENNA, Austria 

Tel: (222) 2365110 

Telex: 13 4425 HEPA A 


NORTHERN EUROPE 
Hewlett-Packard S.A. 
Uilenstede 475 

P.0.Box 999 

NL-1180 AZ AMSTELVEEN 
The Netherlands 

Tel: 20 437771 


SOUTH EAST EUROPE 
Hewlett-Packard S.A. 

7, Rue du Bois-du-Lan 

CH- 1217 MEYRIN 2, Switzerland 
Tel: (022) 83 12 12 

Telex: 27835 hpse 

Cable: HEWPACKSA Geneve 


OTHER EUROPE 
Hewlett-Packard S.A. 

P.O. Box 

150, Rte du Nant-D’Avril 
CH-1217 MEYRIN 2, Switzerland 
Tel: (022) 83 8111 

Telex: 22486 hpsa 

Cable: HEWPACKSA Geneve 


MEDITERRANEAN AND 
MIDDLE EAST 
Hewlett-Packard S.A. 
Mediterranean and Middle East 
Operations 

Atrina Centre 

32 Kifissias Ave. 
Paradissos-Amarousion, ATHENS 
Greece 

Tel: 682 88 11 

Telex: 21-6588 HPAT GR 
Cable: HEWPACKSA Athens 


EASTERN USA 
Hewlett-Packard Co. 
4 Choke Cherry Road 
ROCKVILLE, MD 20850 
Tel: (301) 258-2000 


MIDWESTERN USA 
Hewlett-Packard Co. 

5201 Tollview Drive 

ROLLING MEADOWS, IL 60008 
Tel: (312) 255-9800 


SOUTHERN USA 
Hewlett-Packard Co. 
2000 South Park Place 
P.O. Box 105005 
ATLANTA, GA 30348 
Tel: (404) 955-1500 


WESTERN USA 
Hewlett-Packard Co. 
3939 Lankershim Bivd. 
P.0. Box 3919 

LOS ANGELES, CA 91604 
Tel: (213) 506-3700 


OTHER INTERNATIONAL 
AREAS 

Hewlett-Packard Co. 
Intercontinental Headquarters 
3495 Deer Creek Road 

PALO ALTO, CA 94304 

Tel: (415) 857-1501 

Telex: 034-8300 

Cable: HEWPACK 


SALES & SUPPORT OFFICES 


Arranged alphabetically by country 


ANGOLA 

Telectra 

Empresa Técnica de Equipamentos 
R. Barbosa Rodrigues, 41-1 DT. 
Caixa Postal 6487 

LUANDA 

Tel: 355 15,355 16 

EP 


ARGENTINA 
Hewlett-Packard Argentina S.A. 
Avenida Santa Fe 2035 
Martinez 1640 BUENOS AIRES 
Tel: 798-5735, 792-1293 
Telex: 17595 BIONAR 

Cable: HEWPACKARG 
A,E,CH,CS,P 

Biotron S.A.C.1LM. el. 

Av Paseo Colon 221, Piso 9 
1399 BUENOS AIRES 

Tel: 30-4846, 30-1851 
Telex: 17595 BIONAR 

M 


AUSTRALIA 


Adelaide, South Australia 
Office 

Hewlett-Packard Australia Ltd. 
153 Greenhill Road 

PARKSIDE, S.A. 5063 

Tel: 272-5911 

Telex: 82536 

Cable: HEWPARD Adelaide 

A* ,CH,CM,,E,MS,P 


Brisbane, Queensland Office 
Hewlett-Packard Australia Ltd. 

10 Payne Road 

THE GAP, Queensland 4061 

Tel: 30-4133 

Telex: 42133 

Cable: HEWPARD Brisbane 
A,CH,CM,E,M,P 


Canberra, Australia 
Capital Territory 
Office 

Hewlett-Packard Australia Ltd. 
121 Wollongong Street 
FYSHWICK, A.C.T. 2609 

Tel: 80 4244 

Telex: 62650 

Cable: HEWPARD Canberra 
CH,CM,E,P 


Melbourne, Victoria Office 
Hewlett-Packard Australia Ltd. 
31-41 Joseph Street 

BLACKBURN, Victoria 3130 

Tel: 895-2895 

Telex: 31-024 

Cable: HEWPARD Melbourne 
A,CH,CM,CS,E,MS,P 


Perth, Western Australia 
Office 

Hewlett-Packard Australia Ltd. 
261 Stirling Highway 
CLAREMONT, W.A. 6010 

Tel: 383-2188 

Telex: 93859 

Cable: HEWPARD Perth 
A,CH,CM,E,MS,P 


a 
o 


Sydney, New South Wales 
Office 

Hewlett-Packard Australia Ltd. 
17-23 Talavera Road 

P.O. Box 308 

NORTH RYDE, N.S.W. 2113 

Tel: 887-1611 

Telex: 21561 

Cable: HEWPARD Sydney 
A,CH,CM,CS,E,MS,P 


AUSTRIA 
Hewlett-Packard Ges.m.b.h. 
Grottenhofstrasse 94 
A-8052 GRAZ 

Tel: (0316) 291 5 66 
Telex: 32375 

CH,E 

Hewlett-Packard Ges.m.b.h. 
Lieblgasse 1 

P.O. Box 72 

A-1222 VIENNA 

Tel: (0222) 23 65 11-0 
Telex: 134425 HEPA A 
A,CH,CM,CS,E,MS,P 


BAHRAIN 

Green Salon 

P.O. Box 557 
Manama 

BAHRAIN 

Tel: 255503-255950 
Telex: 84419 

Pp 

Wael Pharmacy 

P.O. Box 648 
BAHRAIN 

Tel: 256123 

Telex: 8550 WAEL BN 
E,C,M 


BELGIUM 

Hewlett-Packard Beigium S.A./N.V. 
Blvd de la Woluwe, 100 
Woluwedal 

B-1200 BRUSSELS 

Tel: (02) 762-32-00 

Telex: 23-494 paloben bru 
A,CH,CM,CS,E,MP,P 


BRAZIL 

Hewlett-Packard do Brasil |.e.C. Ltda. 
Alameda Rio Negro, 750 
Alphaville 

06400 BARUERI SP 

Tel: (011) 421.1311 

Telex: (011) 33872 HPBR-BR 
Cable: HEWPACK Sao Paulo 
A,CH,CM,CS,E,M,P 
Hewlett-Packard do Brasil I.e.C. Ltda. 
Avenida Epitacio Pessoa, 4664 
2247 1 RIO DE JANEIRO-RJ 

Tel: (O21) 286.0237 

Telex: 021-21905 HPBR-BR 
Cable: HEWPACK Rio de Janeiro 
A,CH,CM,E,MS,P* 

ANAMED 1.C.E.1. Ltda. 

Rua Bage, 103 

04012 SAO PAULO 

Tel: (011) 570-5726 

Telex: 021-21905 HPBR-BR 

M 


a 
a 


SALES & SUPPORT OFFICES 


Arranged alphabetically by country 


CANADA 


Alberta 

Hewlett-Packard (Canada) Ltd. 
3030 3rd Avenue N.E. 
CALGARY, Alberta T2A 617 
Tel: (403) 235-3100 
A,CH,CM,E* ,MS,P* 


Hewlett-Packard (Canada) Ltd. 
11120A- 178th Street 
EDMONTON, Alberta T5S 1P2 
Tel: (403) 486-6666 
A,CH,CM,CS,E,MS,P 


British Columbia 
Hewlett-Packard (Canada) Ltd. 
10691 Shellbridge Way 
RICHMOND, 

British Columbia V6X 2W7 

Tel: (604) 270-2277 

Telex: 610-922-5059 
A,CH,CM,CS,E*,MS,P* 


Manitoba 

Hewlett-Packard (Canada) Ltd. 
380-550 Century Street 
WINNIPEG, Manitoba R3H OY 1 
Tel: (204) 786-6701 
A,CH,CM,E,MS,P* 


Nova Scotia 

Hewlett-Packard (Canada) Ltd. 

P.O. Box 931 

900 Windmill Road 

DARTMOUTH, Nova Scotia B2Y 3Z6 
Tel: (902) 469-7820 
CH,CM,CS,E*,MS,P* 


Ontario 

Hewlett-Packard (Canada) Ltd. 
3325 N. Service Rd., Unit 6 
BURLINGTON, Ontario P3A 2A3 
Tel: (416) 335-8644 

CS,M* 

Hewlett-Packard (Canada) Ltd. 
552 Newbold Street 

LONDON, Ontario N6E 2S5 

Tel: (519) 686-9181 
A,CH,CM,E*,MS,P* 
Hewlett-Packard (Canada) Ltd. 
6877 Goreway Drive 
MISSISSAUGA, Ontario L4V 1M8 
Tel: (416) 678-9430 
A,CH,CM,CS,E,MP,P 
Hewlett-Packard (Canada) Ltd. 
2670 Queensview Dr. 
OTTAWA, Ontario K2B 8K 1 
Tel: (613) 820-6483 
A,CH,CM,CS,E*,MS,P* 
Hewlett-Packard (Canada) Ltd. 
220 Yorkland Blvd., Unit #11 
WILLOWDALE, Ontario M2J 1R5 
Tel: (416) 499-9333 

CH 


Quebec 

Hewlett-Packard (Canada) Ltd. 
17500 South Service Road 
Trans-Canada Highway 
KIRKLAND, Quebec H9J 2M5 
Tel: (514) 697-4232 
A,CH,CM,CS,E,MP,P * 
Hewlett-Packard (Canada) Ltd. 
Les Galeries du Vallon 

2323 Du Versont Nord 

STE. FOY, Quebec G1N 4C2 
Tel: (418) 687-4570 

CH 


CHILE 

Jorge Calcagni y Cia. Ltda. 
Av. Italia 634 Santiago 
Casilla 16475 

SANTIAGO 9 

Tel: 222-0222 

Telex: Public Booth 440001 
A,CM,E,M 

Olympia (Chile) Lida. 

Av. Rodrigo de Araya 1045 
Casilla 256-V 

SANTIAGO 21 

Tel: (02) 22 55 044 

Telex: 240-565 OLYMP CL 
Cable: Olympiachile Santiagochile 
CH,CS,P 


CHINA, People’s Republic of 
China Hewlett-Packard Rep. Office 
P.0. Box 418 

1A Lane 2, Luchang St. 

Beiwei Rd., Xuanwu District 

BEIJING 

Tel: 33-1947, 33-7426 

Telex: 22601 CTSHP CN 

Cable: 1920 

A,CH,CM,CS,E,P 


COLOMBIA 
Instrumentaci6n 

H. A. Langebaek & Kier S.A. 
Carrera 4A No. 52A-26 
Apartado Aereo 6287 
BOGOTA 1, D.E. 

Tel: 212-1466 

Telex: 44400 INST CO 
Cable: AARIS Bogota 
CM,E,M 

Casa Humboldt Ltda. 
Carrera 14, No. 98-60 
Apartado Aereo 51283 
BOGOTA 1, D.E. 

Tel: 256-1686 

Telex: 45403 CCAL CO. 
A 


COSTA RICA 

Cientifica Costarricense S.A. 
Avenida 2, Calle § 

San Pedro de Montes de Oca 
Apartado 10159 

SAN JOSE 

Tel: 24-38-20, 24-08-19 
Telex: 2367 GALGUR CR 
CM,E,M 


CYPRUS 

Telerexa Lid. 

P.O. Box 4809 

14C Stassinos Avenue 
NICOSIA 

Tel: 62698 

Telex: 2894 LEVIDO CY 
E,M,P 


DENMARK 
Hewlett-Packard A/S 
Datavej 52 

DK-3460 BIRKEROD 
Tel: (02) 81-66-40 
Telex: 37409 hpas dk 
A,CH,CM,CS,E,MS,P 
Hewlett-Packard A/S 
Rolighedsvej 32 
DK-8240 RISSKOV, Aarhus 
Tel: (06) 17-60-00 
Telex: 37409 hpas dk 
CH,E 


DOMINICAN REPUBLIC 
Microprog S.A. 

Juan Tomas Mejia y Cotes No. 60 
Arroyo Hondo 

SANTO DOMINGO 

Tel: 565-6268 

Telex: 4510 ARENTA DR (RCA) P 


ECUADOR 

CYEDE Cia. Ltda. 

Avenida Eloy Alfaro 1749 
Casilla 6423 CCI 

QUITO 

Tel: 450-975, 243-052 
Telex: 2548 CYEDE ED 
CM,E,P 

Hospitalar S.A. 

Robles 625 

Casilla 3590 

QUITO 

Tel: 545-250, 545-122 
Telex: 2485 HOSPTL ED 
Cable: HOSPITALAR-Quito 
M 


EGYPT 

International Engineering Associates 
24 Hussein Hegazi Street 
Kasr-el-Aini 

CAIRO 

Tel: 23829, 21641 
Telex: IEA UN 93830 
CH,CS,E,M 

EGYPOR 

P.0.Box 2558 

42 El Zahraa Street 
CAIRO, Egypt 

Tel: 65 00 21 

Telex: 93 337 

P 


EL SALVADOR 
IPESA de El Salvador S.A. 
29 Avenida Norte 1216 
SAN SALVADOR 

Tel: 26-6858, 26-6868 
Telex: 20539 IPESASAL 
A,CH,CM,CS,E,P 


FINLAND 
Hewlett-Packard Oy 
Revontulentie 7 

PL 24 

SF-02101 ESPOO 10 
Tel: (90) 4560211 
Telex: 121563 hewpa sf 
CH,CM,CS,P 
Hewlett-Packard Oy 
(Olariniuoma 7) 

PL 24 

02101 ESPOO 10 

Tel: (90) 4521022 
A,E,MS 

Hewlett-Packard Oy 
Aatoksenkatv 10-C 
SF-40720-72 JYVASKYLA 
Tel: (941) 216318 

CH 


Hewlett-Packard Oy 
Kainvuntie 1-C 
SF-90140-14 OULU 
Tel: (981) 338785 
CH 


FRANCE 
Hewlett-Packard France 
Z.|. Mercure B 

Rue Berthelot 

F-13763 Les Milles Cedex 
AIX-EN-PROVENCE 

Tel: 16 (42) 59-41-02 
Telex: 410770F 
A,CH,E,MS,P* 
Hewlett-Packard France 
64, rue Marchand Saillant 
F-61000 ALENCON 

Tel: 16 (33) 29 04 42 


Hewlett-Packard France 
Boite Postale 503 
F-25026 BESANCON 

28 rue de la Republique 
F-25000 BESANCON 
Tel: 16 (81) 83-16-22 
CH.M 

Hewlett-Packard France 
13, Place Napoleon Ill 
F-29000 BREST 

Tel: 16 (98) 03-38-35 
Hewlett-Packard France 
Chemin des Mouilles 
Boite Postale 162 
F-69130 ECULLY Cedex (Lyon) 
Tel: 16 (78) 833-81-25 
Telex: 310617F 
A,CH,CS,E,MP 
Hewlett-Packard France 
Tour Lorraine 
Boulevard de France 
F-91035 EVRY Cedex 
Tel: 16 6 077-96-60 
ao 6923 15F 


Hewlett-Packard France 

Parc d’Activite du Bois Briard 
Ave. du Lac 

F-91040 EVRY Cedex 

Tel: 16 6 077-8383 

Telex: 6923 15F 

E 


Hewlett-Packard France 

5, avenue Raymond Chanas 
F-38320 EYBENS (Grenoble) 

Tel: 16 (76) 25-81-41 

Telex: 980124 HP GRENOB EYBE 
CH 


Hewlett-Packard France 
Centre d’Affaire Paris-Nord 
Batiment Ampére 5 étage 
Rue de la Commune de Paris 
Boite Postale 300 

F-93153 LE BLANC MESNIL 
Tel: 16 (1) 865-44-52 
Telex: 211032F 

CH,CS,E,MS 

Hewlett-Packard France 

Parc d’Activités Cadera 
Quartier Jean Mermoz 
Avenue du Président JF Kennedy 
F-33700 MERIGNAC (Bordeaux) 
Tel: 16 (56) 34-00-84 
Telex: 550105F 

CH,E,MS 

Hewlett-Packard France 
Immueble “Les 3 B” 
Nouveau Chemin de la Garde 
ZAC de Bois Briand 

F-44085 NANTES Cedex 

Tel: 16 (40) 50-32-22 

CH et 
































FRANCE (Cont’d) 
Hewlett-Packard France 

125, rue du Faubourg Bannier 
F-45000 ORLEANS 

Tel: 16 (38) 68 01 63 


Hewlett-Packard France 

Zone Industrielle de Courtaboeuf 
Avenue des Tropiques 
F-91947 Les Ulis Cedex ORSAY 
Tel: (6) $07-78-25 

Telex: 600048F 
A,CH,CM,CS,E,MP,P 
Hewlett-Packard France 

Paris Porte-Maillot 

15, Avenue de L’Amiral Bruix 
F-75782 PARIS CEDEX 16 

Tel: 16 (1) 502-12-20 

Telex: 613663F 

CH,MS,P 

Hewlett-Packard France 

124, Boulevard Tourasse 
F-64000 PAU 

Tel: 16 (59) 80 38 02 


Hewlett-Packard France 

2 Allée de la Bourgonnette 
F-35100 RENNES 

Tel: 16 (99) 51-42-44 
Telex: 7409 12F 
CH,CM,E,MS,P* 
Hewlett-Packard France 
98 Avenue de Bretagne 
F-76100 ROUEN 

Tel: 16 (35) 63-57-66 
CH**,CS 

Hewlett-Packard France 

4 Rue Thomas Mann 

Boite Postale 56 

F-67033 STRASBOURG Cedex 
Tel: 16 (88) 28-56-46 
Telex: 89014 1F 
CH,E,MS,P* 
Hewlett-Packard France 
Le Péripole 

20, Chemin du Pigeonnier de la 
Cépiére 

F-31083 TOULOUSE Cedex 
Tel: 16 (61) 40-11-12 
Telex: 53 1639F 
A,CH,CS,E,P* 
Hewlett-Packard France 

9, rue Baudin 

F-26000 VALENCE 

Tel: 16 (75) 42 76 16 


Hewlett-Packard France 
Carolor 

ZAC de Bois Briand 
F-57640 VIGY (Metz) 
Tel: 16 (8) 771 20 22 
CH 


Hewlett-Packard France 

Immeuble Péricentre 

F-59658 VILLENEUVE D’ASCQ Cedex 
Tel: 16 (20) 91-41-25 

Telex: 160124F 

CH,E,MS,P* 


GERMAN FEDERAL 
REPUBLIC 
Hewlett-Packard GmbH 
Geschiftsstelle 
Keithstrasse 2-4 

D- 1000 BERLIN 30 

Tel: (030) 24-90-86 
Telex: 018 3405 hpbin d 
A,CH,E,M,P 


Hewlett-Packard GmbH 
Geschiftsstelle 
Herrenberger Strasse 130 
D-7030 BOBLINGEN 

Tel: (7031) 14-0 

Telex: 

A,CH,CM,CS,E,MP,P 
Hewlett-Packard GmbH 
Geschaftsstelle 
Emanuel-Leutze-Strasse 1 
D-4000 DUSSELDORF 

Tel: (0211) 5971-1 

Telex: 085/86 533 hpdd d 
A,CH,CS,E,MS,P 
Hewlett-Packard GmbH 
Geschéftsstelle 

Schleefstr. 28a 

D-4600 DORTMUND-Aplerbeck 
Tel: (0231) 45001 


Hewlett-Packard GmbH 
Vertriebszentrale Frankfurt 
Berner Strasse 117 
Postfach 560 140 
D-6000 FRANKFURT 56 
Tel: (0611) 50-04-1 
Telex: 04 13249 hpffm d 
A,CH,CM,CS,E,MP,P 
Hewlett-Packard GmbH 
Geschéftsstelle 
Aussenstelle Bad Homburg 
Louisenstrasse 115 
D-6380 BAD HOMBURG 
Tel: (06172) 109-0 


Hewlett-Packard GmbH 
Geschiaftsstelle 
Kapstadtring 5 
D-2000 HAMBURG 60 
Tel: (040) 63804- 1 
Telex: 021 63 032 hphh d 
A,CH,CS,E,MS,P 
Hewlett-Packard GmbH 
Geschaftsstelle 
Heidering 37-39 
D-3000 HANNOVER 61 
Tel: (0511) 5706-0 
Telex: 092 3259 
A,CH,CM,E,MS,P 


~ Hewlett-Packard GmbH 


Geschaftsstelle 
Rosslauer Weg 2-4 
D-6800 MANNHEIM 

Tel: (0621) 70050 
Telex: 0462105 

A,C,E 

Hewlett-Packard GmbH 
Geschaftsstelle 
Messerschmittstrasse 7 
D-7910 NEU ULM 

Tel: 0731-70241 
Telex: 0712816 HP ULM-D 
A,C,E* 
Hewlett-Packard GmbH 
Geschaftsstelle 
Ehhericherstr. 13 
D-8500 NURNBERG 10 
Tel: (0911) 5205-0 
Telex: 0623 860 
CH,CM,E,MS,P 
Hewlett-Packard GmbH 
Geschiftsstelle 
Eschenstrasse 5 
D-8028 TAUFKIRCHEN 
Tel: (089) 6117-1 
Telex: 0524985 
A,CH,CM,E,MS,P 


SALES & SUPPORT OFFICES [3 | 


Arranged alphabetically by country r¢ 
D 


GREAT BRITAIN 
See United Kingdom 


GREECE 

Kostas Karaynnis S.A. 

8 Omirou Street 

ATHENS 133 

Tel: 32 30 303, 32 37 371 
Telex: 215962 RKAR GR 
A,CH,CM,CS,E,M,P 

PLAISIO S.A. 

G. Gerardos 

24 Stournara Street 
ATHENS 

Tel: 36-11-160 

Telex: 221871 

P 


GUATEMALA 

IPESA 

Avenida Reforma 3-48, Zona 9 
GUATEMALA CITY 

Tel: 316627, 314786 

Telex: 4192 TELTRO GU 
A,CH,CM,CS,E,M,P 


HONG KONG 
Hewlett-Packard Hong Kong, Ltd. 
G.P.0. Box 795 

5th Floor, Sun Hung Kai Centre 
30 Harbour Road 

HONG KONG 

Tel: 5-83232 11 

Telex: 66678 HEWPA HX 
Cable: HEWPACK HONG KONG 
E,CH,CS,P 

CET Lid. 

1402 Tung Wah Mansion 
199-203 Hennessy Rd. 
Wanchia, HONG KONG 

Tel: 5-729376 

Telex: 85148 CET HX 

CM 

Schmiat & Co. (Hong Kong) Lid. 
Wing On Centre, 28th Floor 
Connaught Road, C. 

HONG KONG 

Tel: 5-455644 

Telex: 74766 SCHMX HX 

A,M 


ICELAND 

Elding Trading Company Inc. 
Hatnarnvoli-Tryggvagotu 
P.O. Box 895 

IS-REYKJAVIK 

Tel: 1-58-20, 1-63-03 

M 


INDIA 

Computer products are sold through 
Blue Star Ltd. All computer repairs and 
maintenance service is done through 
Computer Maintenance Corp. 


Blue Star Lid. 

Sabri Complex Il Floor 
24 Residency Rd. 
BANGALORE 560 025 
Tel: 55660 

Telex: 0845-430 
Cable: BLUESTAR 
A,CH*,CM,CS*,E 


Blue Star Ltd. 

Band Box House 
Prabhadevi 

BOMBAY 400 025 

Tel: 422-3101 

Telex: 011-3751 

Cable: BLUESTAR 

A,M 

Blue Star Lid. 

Sahas 

414/2 Vir Savarkar Marg 
Prabhadevi 

BOMBAY 400 025 

Tel: 422-6155 

Telex: 011-4093 

Cable: FROSTBLUE 
A,CH*,CM,CS*,E,M 

Blue Star Ltd. 

Kalyan, 19 Vishwas Colony 
Alkapuri, BORODA, 390 005 
Tel: 65235 

Cable: BLUE STAR 

A 


Blue Star Ltd. 

7 Hare Street 
CALCUTTA 700 001 
Tel: 12-01-31 

Telex: 021-7655 
Cable: BLUESTAR 
A.M 

Blue Star Ltd. 

133 Kodambakkam High Road 
MADRAS 600 034 

Tel: 82057 

Telex: 04 1-379 
Cable: BLUESTAR 
A,M 

Blue Star Lid. 
Bhandari House, 7th/8th Floors 
91 Nehru Place 

NEW DELHI 110 024 
Tel: 682547 

Telex: 031-2463 
Cable: BLUESTAR 
A,CH*,CM,CS*,E,M 

Blue Star Ltd. 

15/16:C Wellesley Rd. 
PUNE 4171017 

Tel: 22775 

Cable: BLUE STAR 

A 


Blue Star Ltd. 
2-2-47/1108 Bolarum Re. 
SECUNDERABAD 500 003 
Tel: 72057 

Telex: 0155-459 

Cable: BLUEFROST 

AE 

Blue Star Ltd. 

T.C. 7/603 Poornima 


_ Maruthankuzhi 


TRIVANDRUM 695 013 
Tel: 65799 

Telex: 0884-259 
Cable: BLUESTAR 

E 


Computer Maintenance Corporation 
Ltd. 

115, Sarojini Devi Road 
SECUNDERABAD 500 003 

Tel: 310-184, 345-774 

Telex: 031-2960 

CH** 


«| 
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INDONESIA 

BERCA Indonesia P.T. 
P.0.Box 496/Jkt. 

Ji. Abdul Muis 62 
JAKARTA 

Tel: 21-373009 

Telex: 46748 BERSAL IA 
Cable: BERSAL JAKARTA 
P 


BERCA Indonesia P.T. 
P.0.Box 2497/Jkt 

Antara Bidg., 17th Floor 
Jl. Medan Merdeka Selatan 17 
JAKARTA-PUSAT 

Tel: 21-344-181 

Telex: BERSAL IA 

A,CS,E,M 

BERCA Indonesia P. T. 

P.O. Box 174/SBY. 

Ji. Kutei No. 17 

SURABAYA 

Tel: 68172 

Telex: 31146 BERSAL SB 
Cable: BERSAL-SURABAYA 
A*,E,M,P 


IRAQ 

Hewlett-Packard Trading S.A. 
Service Operation 

Al Mansoor City 9B/3/7 
BAGHDAD 

Tel: 55 1-49-73 

Telex: 212-455 HEPAIRAQ IK 
CH,CS 


IRELAND 
Hewlett-Packard Ireland Ltd. 
82/83 Lower Leeson Street 
DUBLIN 2 

Tel: 0001 608800 

Telex: 30439 
A,CH,CM,CS,E,M,P 

Cardiac Services Ltd. 
Kilmore Road 

Arlane 

DUBLIN 5 

Tel: (01) 351820 

Telex: 30439 

M 


ISRAEL 

Eldan Electronic instrument Ltd. 
P.0.Box 1270 

JERUSALEM 91000 

16, Ohaliav St. 

JERUSALEM 94467 

Tel: 533 221, 553 242 

Telex: 25231 AB/PAKRD IL 

A 


Electronics Engineering Division 
Motorola Israel Lid. 

16 Kremenetski Street 

P.O. Box 25016 

TEL-AVIV 67899 

Tel: 3 88 388 

Telex: 33569 Motil IL 

Cable: BASTEL Tel-Aviv 
CH,CM,CS,E,M,P 


ITALY 

Hewlett-Packard Italiana S.p.A 
Traversa 99C 

Via Giulio Petroni, 19 

I-70124 BARI 

Tel: (080) 41-07-44 

M 


Hewlett-Packard Italiana S.p.A. 
Via Martin Luther King, 38/1II 
|-40132 BOLOGNA 

Tel: (051) 402394 

Telex: 511630 

CH,E,MS 

Hewlett-Packard Italiana S.p.A. 
Via Principe Nicola 43G/C 
|-95126 CATANIA 

Tel: (095) 37-10-87 

Telex: 970291 

C,P 

Hewlett-Packard Italiana S.p.A. 
Via G. Di Vittorio 9 

|-20063 CERNUSCO SUL NAVIGLIO 
(Milano) 

Tel: (02) 923691 

Telex: 334632 
A,CH,CM,CS,E,MP,P 
Hewlett-Packard Italiana S.p.A. 
Via C. Colombo 49 


|-20090 TREZZANO SUL NAVIGLIO. 


(Milano) 

Tel: (02) 4459041 

Telex: 322116 

C.M 

Hewlett-Packard Italiana S.p.A. 
Via Nuova San Rocco a 
Capodimonte, 62/A 

|-80131 NAPOLI 

Tel: (081) 7413544 

Telex: 710698 

A,CH,E 

Hewlett-Packard Italiana S.p.A. 
Viale G. Modugno 33 

l-16156 GENOVA PEGLI 

Tel: (010) 68-37-07 

Telex: 215238 

E,C 

Hewlett-Packard Italiana S.p.A. 
Via Pelizzo 15 

1-35 128 PADOVA 

Tel: (049) 664888 

Telex: 430315 

A,CH,E,MS 

Hewlett-Packard Italiana S.p.A. 
Viale C. Pavese 340 

|-00144 ROMA EUR 

Tel: (06) 54831 

Telex: 610514 
A,CH,CM,CS,E,MS,P* 
Hewlett-Packard Italiana S.p.A. 
Via di Casellina 57/C 

I-50018 SCANDICCI-FIRENZE 
Tel: (055) 753863 


Hewlett-Packard Italiana S.p.A. 
Corso Svizzera, 185 

l-10144 TORINO 

Tel: (011) 74 4044 

Telex: 221079 

CHE ° 


JAPAN 
Yokogawa-Hewlett-Packard Ltd. 
152-1, Onna 

ATSUGI, Kanagawa, 243 

Tel: (0462) 28-0451 

CM,C*,E 
Yokogawa-Helwett-Packard Ltd. 
Meiji-Seimei Bldg. 6F 

3-1 Hon Chiba-Cho 

CHIBA, 280 

Tel: 472 25 7701 

E,CH,CS 


Yokogawa-Hewlett-Packard Ltd. 
Yasuda-Seimei Hiroshima Bldg. 
6-11, Hon-dori, Naka-ku 
HIROSHIMA, 730 

Tel: 82-241-0611 


Yokogawa-Hewlett-Packard Ltd. 
Towa Building 

2-3, Kaigan-dori, 2 Chome Chuo-ku 
KOBE, 650 

Tel: (078) 392-4791 


Yokogawa-Hewlett-Packard Ltd. 
Kumagaya Asahi 82 Bldg 

3-4 Tsukuba 

KUMAGAYA, Saitama 360 

Tel: (0485) 24-6563 

CH,CM,E 
Yokogawa-Hewlett-Packard Ltd. 
Asahi Shinbun Daiichi Seimei Bidg. 
4-7, Hanabata-cho 
KUMAMOTO,860 

Tel: (0963) 54-7311 

CH,E 
Yokogawa-Hewlett-Packard Ltd. 
Shin-Kyoto Center Bldg. 

614, Higashi-Shiokoji-cho 
Karasuma-Nishiiru 

Shiokoji-dori, Shimogyo-ku 
KYOTO, 600 

Tel: 075-343-0921 

CH,E 
Yokogawa-Hewlett-Packard Ltd. 
Mito Mitsui Bldg 

4-73, Sanno-maru, 1 Chome 
MITO, Ibaraki 310 

Tel: (0292) 25-7470 

CH,CM,E 
Yokogawa-Hewlett-Packard Ltd. 
Sumitomo Seimei 14-9 Bidg. 
Meieki-Minami, 2 Chome 
Nakamura-ku 

NAGOYA, 450 

Tel: (052) 571-5171 
CH,CM,CS,E,MS 
Yokogawa-Hewlett-Packard Ltd. 
Chuo Bidg., 

4-20 Nishinakajima, 5 Chome 
Yodogawa-ku 

OSAKA, 532 

Tel: (06) 304-6021 

Telex: YHPOSA 523-3624 
A,CH,CM,CS,E,MP,P* 
Yokogawa-Hewlett-Packard Ltd. 
27-15, Yabe, 1 Chome 
SAGAMIHARA Kanagawa, 229 
Tel: 0427 59-1311 


Yokogawa-Hewlett-Packard Ltd. 
Daiichi Seimei Bldg. 

7-1, Nishi Shinjuku, 2 Chome 
Shinjuku-ku, TOKYO 160 

Tel: 03-348-46 11 

CH,E 
Yokogawa-Hewlett-Packard Ltd. 
29-21 Takaido-Higashi, 3 Chome 
Suginami-ku TOKYO 168 

Tel: (03) 331-611 

Telex: 232-2024 YHPTOK 
A,CH,CM,CS,E,MP,P* 
Yokogawa-Hewlett-Packard Ltd. 
Daiichi Asano Building 

2-8, Odori, 5 Chome 
UTSUNOMIYA, Tochigi 320 

Tel: (0286) 25-7155 

CH,CS,E 


Yokogawa-Hewlett-Packard Ltd. 
Yasuda Seimei Nishiguchi Bldg. 
30-4 Tsuruya-cho, 3 Chome 
YOKOHAMA 221 

Tel: (045) 312-1252 

CH,CM,E 


JORDAN 

Mouasher Cousins Company 
P.O. Box 1387 

AMMAN 

Tel: 24907, 39907 

Telex: 21456 SABCO JO 
CH,E,M,P 


KENYA 

ADCOM Lid., Inc., Kenya 
P.0.Box 30070 

NAIROBI 

Tel: 331955 

Telex: 22639 

E,M 


KOREA 

Samsung Electronics HP Division 
12 Fl. Kinam Bldg. 

San 75-31, Yeoksam-Dong 
Kangnam-Ku 

Yeongdong P.O. Box 72 

SEOUL 

Tel: 555-7555, 555-5447 
Telex: K27364 SAMSAN 
A,CH,CM,CS,E,M,P 


KUWAIT 

Al-Khaldiya Trading & Contracting 
P.O. Box 830 Safat 
KUWAIT 

Tel: 42-4910, 41-1726 
Telex: 22481 Areeg kt 
CH,E,M 

Photo & Cine Equipment 
P.O. Box 270 Safat 
KUWAIT 

Tel: 42-2846, 42-3801 
Telex: 22247 Matin kt 

P 


LEBANON 
G.M. Dolmadjian 
Achrafieh 

P.O. Box 165. 167 
BEIRUT 

Tel: 290293 

MP** 

Computer Information Systems 
P.O. Box 11-6274 
BEIRUT 

Tel: 89 40 73 
Telex: 22259 

C 


LUXEMBOURG 
Hewlett-Packard Belgium S.A./N.V. 
Blvd de la Woluwe, 100 
Woluwedal 

B- 1200 BRUSSELS 

Tel: (02) 762-32-00 

Telex: 23-494 paloben bru 
A,CH,CM,CS,E,MP,P 


MALAYSIA 

Hewlett-Packard Sales (Malaysia) 
Sdn. Bhd. 

1st Floor, Bangunan British 
American 

Jalan Semantan, Damansara Heights 
KUALA LUMPUR 23-03 

Tel: 943022 

Telex: MA31011 

A,CH,E,M,P* 
































MAYLAYSIA (Cont'd) 
Protel Engineering 

P.O.Box 1917 

Lot 6624, Section 64 

23/4 Pending Road 
Kuching, SARAWAK 

Tel: 36299 

Telex: MA 70904 PROMAL 
Cable: PROTELENG 

A,E,M 


MALTA 

Philip Toledo Ltd. 
Notabile Rd. 

MRIEHEL 

Tel: 447 47, 455 66 
Telex: Media MW 649 
EP 


MEXICO 

Hewlett-Packard Mexicana, S.A. 
de C.V. 

Av. Periferico Sur No. 6501 
Tepepan, Xochimilco 

16020 MEXICO D.F. 

Tel: 6-76-46-00 

Telex: 17-74-507 HEWPACK MEX 
A,CH,CS,E,MS,P 
Hewlett-Packard Mexicana, S.A. 
de C.V. 

Ave. Colonia del Valle 409 

Col. del Valle 

Municipio de Garza Garcia 
MONTERREY, Nuevo Leon 

Tel: 78 42 41 

Telex: 038 410 

CH 


ECISA 

José Vasconcelos No. 218 

Col. Condesa Deleg. Cuauhtémoc 
MEXICO D.F. 06140 

Tel: 553-1206 

Telex: 17-72755 ECE ME 

M 


MOROCCO 
Dolbeau 

81 rue Karatchi 
CASABLANCA 

Tel: 304 1-82, 3068-38 
Telex: 23051, 22822 
E 


Gerep 

2 rue d'Agadir 

Boite Postale 156 
CASABLANCA 

Tel: 272093, 272095 
Telex: 23 739 

P 


NETHERLANDS 
Hewlett-Packard Nederland B.V. 
Van Heuven Goechartlaan 121 
NL 1181KK AMSTELVEEN 

P.O. Box 667 

NL1180 AR AMSTELVEEN 

Tel: (020) 47-20-21 

Telex: 13 216 HEPA NL 
A,CH,CM,CS,E,MP,P 
Hewlett-Packard Nederland B.V. 
Bongerd 2 

NL 2906VK CAPELLE A/D IJSSEL 
P.O. Box 41 

NL 2900AA CAPELLE A/D IJSSEL 
Tel: (10) 51-64-44 

Telex: 21261 HEPAC NL 
A,CH,CS,E 


Hewlett-Packard Nederland B.V. 
Pastoor Petersstraat 134-136 
NL 5612 LV EINDHOVEN 

P.0. Box 2342 

NL 5600 CH EINDHOVEN 

Tel: (040) 326911 

Telex: 51484 hepae ni 

A,CH* *,E,M 


NEW ZEALAND 
Hewlett-Packard (N.Z.) Ltd. 
5 Owens Road 

P.O. Box 26-189 

Epsom, AUCKLAND 

Tel: 687-159 

Cable: HEWPACK Auckland 
CH,CM,E,P* 
Hewlett-Packard (N.Z.) Ltd. 
4-12 Cruickshank Street 
Kilbirnie, WELLINGTON 3 
P.O. Box 9443 

Courtenay Place, WELLINGTON 3 
Tel: 877-199 

Cable: HEWPACK Wellington 
CH,CM,E,P 


Northrop Instruments & Systems Lid. 
369 Khyber Pass Road 

P.O. Box 8602 

AUCKLAND 

Tel: 794-091 

Telex: 60605 

A,M 

Northrop Instruments & Systems Lid. 
110 Mandeville St. 

P.O. Box 8388 

CHRISTCHURCH 

Tel: 486-928 

Telex: 4203 

A,M 

Northrop Instruments & Systems Ltd. 
Sturdee House 

85-87 Ghuznee Street 

P.O. Box 2406 

WELLINGTON 

Tel: 850-091 

Telex: NZ 3380 

A,M 


NORTHERN IRELAND 
See United Kingdom 


NORWAY 
Hewlett-Packard Norge A/S 
Folke Bernadottes vei 50 
P.O. Box 3558 

N-5033 FYLLINGSDALEN (Bergen) 
Tel: 0047/5/16 55 40 
Telex: 16621 hpnas n 
CH,CS,E,MS 
Hewlett-Packard Norge A/S 
Osterndalen 16-18 

P.O. Box 34 

N-1345 OSTERAS 

Tel: 0047/2/17 11 80 
Telex: 16621 hpnas n 
A,CH,CM,CS,E,M,P 


OMAN 

Khimjil Ramdas 

P.O. Box 19 

MUSCAT 

Tel: 722225, 745601 

Telex: 3289 BROKER MB MUSCAT 
P 


Suhail & Saud Bahwan 
P.O.Box 169 

MUSCAT 

Tel: 734 201-3 

Telex: 3274 BAHWAN MB 
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PAKISTAN 

Mushko & Company Lid. 
1-B, Street 43 

Sector F-8/1 

ISLAMABAD 

Tel: 51071 

Cable: FEMUS Rawalpindi 
A,E,M 

Mushko & Company Lid. 
Oosman Chambers 
Abdullah Haroon Road 
KARACHI 0302 

Tel: 524131, 524132 
Telex: 2894 MUSKO PK 
Cable: COOPERATOR Karachi 
A,E,M,P* 


PANAMA 

Electrénico Balboa, S.A. 
Calle Samuel Lewis, Ed. Alfa 
Apartado 4929 

PANAMA 5 

Tel: 63-6613, 63-6748 
Telex: 3483 ELECTRON PG 
A,CM,E,M,P 


PERU 

Cia Electro Médica S.A. 

Los Flamencos 145, San Isidro 
Casilla 1030 

LIMA 1 

Tel: 41-4325, 41-3703 

Telex: Pub. Booth 25306 
CM,E,M,P 


PHILIPPINES 

The Online Advanced Systems 
Corporation 

Rico House, Amorsolo Cor. Herrera 
Street 

Legaspi Village, Makati 

P.O. Box 1510 

Metro MANILA 

Tel: 85-35-81, 85-34-91, 85-32-21 
Telex: 3274 ONLINE 

A,CH,CS,E,M 

Electronic Specialists and Proponents 
Inc. 

690-B Epifanio de los Santos Avenue 
Cubao, QUEZON CITY 

P.O. Box 2649 Manila 

Tel: 98-96-81, 98-96-82, 98-96-83 
Telex: 40018, 42000 ITT GLOBE 
MACKAY BOOTH 

P 


PORTUGAL 

Mundinter 

Intercambio Mundial de Comércio 
S.AARLL. 

P.O. Box 2761 

Av. Antonio Augusto de Aguiar 138 
P-LISBON 

Tel: (19) 53-21-31, 53-21-37 
Telex: 16691 munter p 

M 

Soquimica 

Av. da Liberdade, 220-2 

1298 LISBOA Codex 

Tel: 56 21 81/2/3 

Telex: 13316 SABASA 

P 


Telectra-Empresa Técnica de 
Equipmentos Eléctricos S.A.R.L. 
Rua Rodrigo da Fonseca 103 
P.O. Box 2531 

P-LISBON 1 

Tel: (19) 68-60-72 

Telex: 12598 

CH,CS,E,P 


PUERTO RICO 
Hewlett-Packard Puerto Rico 
Ave. Mufioz Rivera #101 
Esq. Calle Ochoa 

HATO REY, Puerto Rico 00918 
Tel: (809) 754-7800 
Hewlett-Packard Puerto Rico 
Calle 272 Edificio 203 

Urb. Country Club 

RIO PIEDRAS, Puerto Rico 

P.O. Box 4407 

CAROLINA, Puerto Rico 00628 
Tel: (809) 762-7255 

A,CH,CS 


QATAR 
Computearbia 

P.O. Box 2750 
DOHA 

Tel: 883555 

Telex: 4806 CHPARB 
P 


Eastern Technical Services 
P.0.Box 4747 

DOHA 

Tel: 329 993 

Telex: 4156 EASTEC DH 


Nasser Trading & Contracting 
P.0.Box 1563 

DOHA 

Tel: 22170, 23539 

Telex: 4439 NASSER DH 

M 


SAUDI ARABIA 
Modern Electronic Establishment 
Hewlett-Packard Division 
P.O. Box 22015 

Thuobah 

AL-KHOBAR 

Tel: 895-1760, 895-1764 
Telex: 671 106 HPMEEK SJ 
Cable: ELECTA AL-KHOBAR 
CH,CS,E,M 

Modern Electronic Establishment 
Hewlett-Packard Division 
P.O. Box 1228 

Redec Plaza, 6th Floor 
JEDDAH 

Tel: 644 38 48 

Telex: 4027 12 FARNAS SJ 
Cable: ELECTA JEDDAH 
CH,CS,E,M 

Modern Electronic Establishment 
Hewlett-Packard Division 
P.0.Box 22015 

RIYADH 

Tel: 491-97 15, 491-63 87 
Telex: 202049 MEERYD SJ 
CH,CS,E,M 

Abdul Ghani El Ajou 

P.O. Box 78 

RIYADH 

Tel: 40 41717 

Telex: 200 932 EL AJOU 

P 


SCOTLAND 
See United Kingdom 


SINGAPORE 

Hewlett-Packard Singapore (Sales) 
Pte. Ltd. 

#08-00 Inchcape House 

450-2 Alexandra Road 

P.O. Box 58 Alexandra Rd. Post Office 
SINGAPORE, 9115 

Tel: 631788 

Telex: HPSGSO RS 34209 

Cable: HEWPACK, Singapore 
A,CH,CS,E,MS,P 


L° | 
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SINGAPORE (Cont’d) 
Dynamar International Ltd. 
Unit 05-11 Block 6 

Kolam Ayer Industrial Estate 
SINGAPORE 1334 

Tel: 747-6 188 

Telex: RS 26283 

CM 


SOUTH AFRICA 


Hewlett-Packard So Africa (Pty.) Ltd. 


P.O. Box 120 

Howard Place CAPE PROVINCE 7450 
Pine Park Center, Forest Drive, 
Pinelands 

CAPE PROVINCE 7405 

Tel: 53-7954 

Telex: 57-20006 

A,CH,CM,E,MS,P 


Hewlett-Packard So Africa (Pty.) Ltd. 


P.O. Box 37099 

92 Overport Drive 

DURBAN 4067 

Tel: 28-4178, 28-4179, 28-4110 
Telex: 6-22954 

CH,CM 


Hewlett-Packard So Africa (Pty.) Ltd. 


6 Linton Arcade 

511 Cape Road 
Linton Grange 

PORT ELIZABETH 6000 
Tel: 041-302 148 

CH 


Hewlett-Packard So Africa (Pty.) Ltd. 


P.0.Box 33345 

Glenstantia 0010 TRANSVAAL 
1st Floor East 

Constantia Park Ridge Shopping 
Centre 

Constantia Park 

PRETORIA 

Tel: 982043 

Telex: 32163 

CH,E 


Hewlett-Packard So Africa (Pty.) Ltd. 


Private Bag Wendywood 
SANDTON 2144 

Tel: 802-5111, 802-5125 
Telex: 4-20877 

Cable: HEWPACK Johannesburg 
A,CH,CM,CS,E,MS,P 


SPAIN 

Hewlett-Packard Espafiola S.A. 
Calle Entenza, 321 
E-BARCELONA 29 

Tel: 322.24.51, 321.73.54 
Telex: 52603 hpbee 
A,CH,CS,E,MS,P 
Hewlett-Packard Espafiola S.A. 
Calle San Vicente S/No 

Edificio Albia Il 

E-BILBAO 1 

Tel: 423.83.06 

A,CH,E,MS 

Hewlett-Packard Espafiola S.A. 
Crta. de la Corufia, Km. 16, 400 
Las Rozas 

E-MADRID 

Tel: (1) 6387.00.11 

CH,CS,M 

Hewlett-Packard Espafiola S.A. 
Avda. S. Francisco Javier, S/no 
Planta 10. Edificio Sevilla 2, 
E-SEVILLA 5 

Tel: 64.44.54 

Telex: 72933 

A,CS,MS,P 


Hewlett-Packard Espafiola S.A. 
Calle Ramon Gordillo, 1 (Entlo.3) 
E-VALENCIA 10 

Tel: 361-1354 

CH,P 


SWEDEN 

Hewlett-Packard Sverige AB 
Sunnanvagen 14K 

S-22226 LUND 

Tel: (046) 13-69-79 

Telex: (854) 17886 (via Spanga 
office) 

CH 


Hewlett-Packard Sverige AB 
Ostra Tullgatan 3 

S-21128 MALMO 

Tel: (040) 70270 

Telex: (854) 17886 (via Spanga 
Office) 

Hewlett-Packard Sverige AB 
Vastra Vintergatan 9 

S-70344 OREBRO 

Tel: (19) 10-48-80 

Telex: (854) 17886 (via Spanga 
Office) 

CH 


Hewlett-Packard Sverige AB 
Skalholtsgatan 9, Kista 

Box 19 

S-16393 SPANGA 

Tel: (08) 750-2000 

Telex: (854) 17886 

Telefax: (08) 7527781 
A,CH,CM,CS,E,MS,P 
Hewlett-Packard Sverige AB 
Frétallisgatan 30 

S-42 132 VASTRA-FROLUNDA 
Tel: (031) 49-09-50 

Telex: (854) 17886 (via Spanga 
office) 

CH,E,P 


SWITZERLAND 
Hewlett-Packard (Schweiz) AG 
Clarastrasse 12 

CH-4058 BASEL 

Tel: (61) 33-59-20 

A 

Hewlett-Packard (Schweiz) AG 
7, fue du Bois-du-Lan 

Case Postale 365 

CH-1217 MEYRIN 2 

Tel: (0041) 22-83-11-11 
Telex:27333 HPAG CH 
CH,CM,CS 

Hewlett-Packard (Schweiz) AG 
Allmend 2 

CH-8967 WIDEN 

Tel: (0041) 57 31 21 11 
Telex: 53933 hpag ch 

Cable: HPAG CH 
A,CH,CM,CS,E,MS,P 


SYRIA 

General Electronic Inc. 

Nuri Basha Ahnaf Ebn Kays Street 
P.0. Box 5781 

DAMASCUS 

Tel: 33-24-87 

Telex: 411 215 

Cable: ELECTROBOR DAMASCUS 
E 


Midole East Electronics 
P.0.Box 2308 

Abu Rumnaneh 
DAMASCUS 

Tel: 33.45 92 

Telex: 411 304 

M 


TAIWAN 

Hewlett-Packard Far East Ltd. 
Kaohsiung Office 

2/F 68-2, Chung Cheng 3rd Road 
KAOHSIUNG 

Tel: (07) 241-2318 

CH,CS,E 

Hewlett-Packard Far East Ltd. 
Taiwan Branch 

8th Floor 

337 Fu Hsing North Road 
TAIPEI! 

Tel: (02) 712-0404 

Telex: 24439 HEWPACK 
Cable:HEWPACK Taipei 
A,CH,CM,CS,E,M,P 

Ing Lih Trading Co. 

3rd Floor, 7 Jen-Ai Road, Sec. 2 
TAIPEI 100 

Tel: (02) 3948191 

Cable: INGLIH TAIPEI 

A 


THAILAND 

Unimesa ; 

30 Patpong Ave., Suriwong 
BANGKOK 5 

Tel: 235-5727 

Telex: 84439 Simonco TH 
Cable: UNIMESA Bangkok 
A,CH,CS,E,M 

Bangkok Business Equipment Ltd. 
5/5-6 Dejo Road 

BANGKOK 

Tel: 234-8670, 234-8671 
Telex: 87669-BEQUIPT TH 
Cable: BUSIQUIPT Bangkok 
P 


TRINIDAD & TOBAGO 
Caribbean Telecoms Ltd. 
50/A Jerningham Avenue 

P.0. Box 732 

PORT-OF-SPAIN 

Tel: 62-44213, 62-44214 
Telex: 235,272 HUGCO WG 
CM,E,M,P 


TUNISIA 

Tunisie Electronique 

31 Avenue de la Liberte 
TUNIS 

Tel: 280-144 

E,P 

Corema 

1 fer. Av. de Carthage 
TUNIS 

Tel: 253-821 

Telex: 12319 CABAM TN 
M 


TURKEY 

Teknim Company Ltd. 
lran Caddesi No. 7 
Kavaklidere, ANKARA 
Tel: 275800 

Telex: 42155 TKNM TR 
E 


E.MA. 

Medina Eldem Sokak No.4 1/6 
Yuksel Caddesi 

ANKARA 

Tel: 175 622 

Telex: 42 591 

M 


UNITED ARAB EMIRATES 
Emitac Ltd. 

P.O. Box 2711 

ABU DHABI 

Tel: 82 04 19-20 

Cable: EMITAC ABUDHABI 


Emitac Ltd. 

P.O. Box 1641 
SHARJAH 

Tel: 591 181 

Telex: 68136 Emitac Sh 
CH,CS,E,M,P 


UNITED KINGDOM 


GREAT BRITAIN 
Hewlett-Packard Ltd. 
Trafalgar House 
Navigation Road 
ALTRINCHAM 

Cheshire WA14 1NU 

Tel: 061 928 6422 

Telex: 668068 
A,CH,CS,E,M,MS,P 
Hewlett-Packard Ltd. 
Elstree House, Elstree Way 
BOREHAMWOOD, Herts WD6 1SG 
Tel: 01 207 5000 

Telex: 89527 16 
E,CH,CS,P 
Hewlett-Packard Ltd. 
Oakfield House, Oakfield Grove 
Clifton BRISTOL, Avon BS8 2BN 
Tel: 0272 736806 

Telex: 444302 

CH,CS,E,P 
Hewlett-Packard Ltd. 
Bridewell House 

Bridewell Place 

LONDON EC4V 6BS 

Tel: 01 583 6565 

Telex: 298163 

CH,CS,P 

Hewlett-Packard Ltd. 
Fourier House 

257-263 High Street 
LONDON COLNEY 

Herts. AL2 1HA, St. Albans 
Tel: 0727 24400 

Telex: 1-89527 16 

CH,CS 


Hewlett-Packard Ltd. 
Pontefract Road 
NORMANTON, West Yorkshire WF6 1RN 
Tel: 0924 895566 

Telex: 557355 

CH,CS,P 

Hewlett-Packard Ltd. 

The Quadrangle 

106-118 Station Road 
REDHILL, Surrey RH1 1PS 
Tel: 0737 68655 

Telex: 947234 
CH,CS,E,P 
































GREAT BRITAIN (Cont'd) 
Hewlett-Packard Ltd. 
Avon House 

435 Stratford Road 
Shirley, SOLIHULL, West Midlands 
B90 4BL 

Tel: 021 745 8800 
Telex: 339105 
CH,CS,E,P 
Hewlett-Packard Ltd. 
West End House 

41 High Street, West End 
SOUTHAMPTON 
Hampshire S03 3DQ 

Tel: 04218 6767 

Telex: 477138 

CH,CS,P 

Hewlett-Packard Ltd. 
Eskdale Rd. 

Winnersh, WOKINGHAM 
Berkshire RG11 5DZ 

Tel: 0734 696622 

Telex: 848884 

E 


Hewlett-Packard Ltd. 
King Street Lane 
Winnersh, WOKINGHAM 
Berkshire RG11 5AR 
Tel: 0734 784774 
Telex: 847178 
A,CH,CS,E,M,MP,P 
Hewlett-Packard Ltd. 
Nine Mile Ride 
Easthampstead, WOKINGHAM 
Berkshire, 3RG11 3LL 
Tel: 0344 773100 
Telex: 848805 
CH,CS,E,P 


IRELAND 


NORTHERN IRELAND 
Hewlett-Packard Ltd. 
Cardiac Services Building 
95A Finaghy Road South 
BELFAST BT 10 OBY 

Tel: 0232 625-566 

Telex: 747626 

CH,CS 


SCOTLAND 
Hewlett-Packard Ltd. 
SOUTH QUEENSFERRY 
West Lothian, EH30 9TG 
Tel: 031 331 1188 
Telex: 72682 
CH,CM,CS,E,M,P 


UNITED STATES 


Alabama 
Hewlett-Packard Co. 
700 Century Park South, Suite 128 
BIRMINGHAM, AL 35226 
Tel: (205) 822-6802 
A,CH,M 
Hewlett-Packard Co. 
420 Wynn Drive 
HUNTSVILLE, AL 35805 
P.O. Box 7700 
HUNTSVILLE, AL 35807 
Tel: (205) 830-2000 
CH,CM,CS,E,M°* 


Arizona 

Hewlett-Packard Co. 

8080 Pointe Parkway West 
PHOENIX, AZ 85044 

Tel: (602) 273-8000 
A,CH,CM,CS,E,MS 


Hewlett-Packard Co. 
2424 East Aragon Road 
TUCSON, AZ 85706 

Tel: (602) 889-4631 
CH,E,MS** 


California 
Hewlett-Packard Co. 
99 South Hill Dr. 
BRISBANE, CA 94005 
Tel: (415) 330-2500 
CH,CS 


Hewlett-Packard Co. 
P.O. Box 7830 (93747) 
5060 E. Clinton Avenue, Suite 102 
FRESNO, CA 93727 

Tel: (209) 252-9652 
CH,CS,MS 
Hewlett-Packard Co. 
P.O. Box 4230 

1430 East Orangethorpe 
FULLERTON, CA 92631 
Tel: (714) 870-1000 
CH,CM,CS,E,MP 
Hewlett-Packard Co. 
320 S. Kellogg, Suite B 
GOLETA, CA 93117 

Tel: (805) 967-3405 

CH 


Hewlett-Packard Co. 
5400 W. Rosecrans Boulevard 
LAWNDALE, CA 90260 
P.O. Box 92105 

LOS ANGELES, CA 90009 
Tel: (213) 970-7500 
Telex: 910-325-6608 
CH,CM,CS,MP 
Hewlett-Packard Co. 
3155 Porter Oaks Drive 
PALO ALTO, CA 94304 
Tel: (415) 857-8000 
CH,CS,E 

Hewlett-Packard Co. 
4244 So. Market Court, Suite A 
P.O. Box 15976 
SACRAMENTO, CA 95852 
Tel: (916) 929-7222 
A*,CH,CS,E,MS 
Hewlett-Packard Co. 
9606 Aero Drive 

P.0. Box 23333 

SAN DIEGO, CA 92139 
Tel: (619) 279-3200 
CH,CM,CS,E,MP 
Hewlett-Packard Co. 
2305 Camino Ramon “C” 
SAN RAMON, CA 94583 
Tel: (415) 838-5900 
CH,CS 


Hewlett-Packard Co. 
3005 Scott Boulevard 
SANTA CLARA, CA 95050 
Tel: (408) 988-7000 
Telex: 910-338-0586 
A,CH,CM,CS,E,MP 
Hewlett-Packard Co. 
5703 Corsa Avenue 
WESTLAKE VILLAGE, CA 91362 
Tel: (213) 706-6800 

E* CH*,CS* 

Colorado 
Hewlett-Packard Co. 

24 Inverness Place, East 
ENGLEWOOD, CO 80112 
Tel: (303) 649-5000 
A,CH,CM,CS,E,MS 


SALES & SUPPORT OFFICES 


Arranged alphabetically by country ¢ 
D 


Connecticut 
Hewlett-Packard Co. 

47 Barnes Industrial Road South 
P.O. Box 5007 

WALLINGFORD, CT 06492 

Tel: (203) 265-7801 
A,CH,CM,CS,E,MS 


Florida 

Hewlett-Packard Co. 

2901 N.W. 62nd Street 

P.O. Box 24210 

FORT LAUDERDALE, FL 33307 
Tel: (305) 973-2600 
CH,CS,E,MP 

Hewlett-Packard Co. 

6177 Lake Ellenor Drive 

P.O. Box 13910 

ORLANDO, FL 32859 

Tel: (305) 859-2900 
A,CH,CM,CS,E,MS 
Hewlett-Packard Co. 

5750B N. Hoover Blvd., Suite 123 
P.O. Box 15200 

TAMPA, FL 33614 

Tel: (813) 884-3282 

A* ,CH,CM,CS,E* ,M* 


Georgia 
Hewlett-Packard Co. 
2000 South Park Place 
P.O. Box 105005 
ATLANTA, GA 30348 
Tel: (404) 955-1500 
Telex: 810-766-4890 
A,CH,CM,CS,E,MP 


Hawaii 

Hewlett-Packard Co. 
Kawaiahao Plaza, Suite 190 
567 South King Street 
HONOLULU, HI 96813 

Tel: (808) 526-1555 
A,CH,E,MS 


lilinois 
Hewlett-Packard Co. 
304 Eldorado Road 

P.O. Box 1607 
BLOOMINGTON, IL 61701 
Tel: (309) 662-9411 
CH,MS** 


Hewlett-Packard Co. 

1100 31st Street, Suite 100 
DOWNERS GROVE, IL 60515 
Tel: (312) 960-5760 

CH,CS 


Hewlett-Packard Co. 

5201 Tollview Drive 

ROLLING MEADOWS, IL 60008 
Tel: (312) 255-9800 

Telex: 910-687-1066 
A,CH,CM,CS,E,MP 


indiana 

Hewlett-Packard Co. 

7301 No. Shadeland Avenue 
P.O. Box 50807 
INDIANAPOLIS, IN 46250 

Tel: (317) 842-1000 
A,CH,CM,CS,E,MS 


lowa 

Hewlett-Packard Co. 

1776 22nd Street, Suite 1 
WEST DES MOINES, IA 50265 
Tel: (515) 224-1435 
CH,MS* * 


Kansas 

Hewlett-Packard Co. 

7804 East Funston Road, #203 
WICHITA, KS 67207 

Tel: (316) 684-8491 

CH 


Kentucky 

Hewlett-Packard Co. 

10300 Linn Station Road, #100 
LOUISVILLE, KY 40223 

Tel: (502) 426-0100 
A,CH,CS,MS 


Louisiana 
Hewlett-Packard Co. 
160 James Drive East 
ST. ROSE, LA 70087 
P.0. Box 1449 
KENNER, LA 70063 
Tel: (504) 467-4100 
A,CH,CS,E,MS 


Maryland 
Hewlett-Packard Co. 
3701 Koppers Street 
BALTIMORE, MD 21227 
Tel: (301) 644-5800 
Telex: 710-862-1943 
A,CH,CM,CS,E,MS 
Hewlett-Packard Co. 

2 Choke Cherry Road 
ROCKVILLE, MD 20850 
Tel: (301) 948-6370 
A,CH,CM,CS,E,MP 


Massachusetts 
Hewlett-Packard Co. 
1775 Minuteman Road 
ANDOVER, MA 01810 
Tel: (617) 682-1500 
A,C,CH,CS,CM,E,MP,P* 
Hewlett-Packard Co. 
32 Hartwell Avenue 
LEXINGTON, MA 02173 
Tel: (617) 861-8960 
CH,CS,E 


Michigan 
Hewlett-Packard Co. 
4326 Cascade Road S.E. 
GRAND RAPIDS, MI 49506 
Tel: (616) 957-1970 
CH,CS,MS 
Hewlett-Packard Co. 
1771 W. Big Beaver Road 
TROY, Mi 48084 

Tel: (313) 643-6474 
CH,CS 


Minnesota 
Hewlett-Packard Co. 
2025 W. Larpenteur Ave. 
ST. PAUL, MN 55113 
Tel: (612) 644-1100 
A,CH,CM,CS,E,MP 


Missouri 
Hewlett-Packard Co. 
11131 Colorado Avenue 
KANSAS CITY, MO 64137 
Tel: (816) 763-8000 
A,CH,CM,CS,E,MS 
Hewlett-Packard Co. 
13001 Hollenberg Drive 
BRIDGETON, MO 63044 
Tel: (314) 344-5100 
A,CH,CS,E,MP 


@- 


SALES & SUPPORT OFFICES 


Arranged alphabetically by country 


UNITED STATES (Cont'd) 


Nebraska 
Hewlett-Packard 

10824 Old Mill Rd., Suite 3 
OMAHA, NE 68154 

Tel: (402) 334-1813 
CM,MS 


New Jersey 
Hewlett-Packard Co. 
120 W. Century Road 
PARAMUS, NJ 07652 
Tel: (201) 265-5000 
A,CH,CM,CS,E,MP 
Hewlett-Packard Co. 

60 New England Av. West 
PISCATAWAY, NJ 08854 
Tel: (201) 981-1199 
A,CH,CM,CS,E 


New Mexico 
Hewlett-Packard Co. 
11300 Lomas Bivd.,N.E. 
P.O. Box 11634 
ALBUQUERQUE, NM 87112 
Tel: (505) 292-1330 
CH,CS,E,MS 


New York 
Hewlett-Packard Co. 
5 Computer Drive South 
ALBANY, NY 12205 
Tel: (518) 458-1550 
A,CH,E,MS 
Hewlett-Packard Co. 
9600 Main Street 
P.O. Box AC 
CLARENCE, NY 14031 
Tel: (716) 759-8621 
CH 


Hewlett-Packard Co. 

200 Cross Keys Office Park 
FAIRPORT, NY 14450 
Tel: (716) 223-9950 
CH,CM,CS,E,MS 
Hewlett-Packard Co. 
7641 Henry Clay Blvd. 
LIVERPOOL, NY 13088 
Tel: (315) 451-1820 
A,CH,CM,E,MS 
Hewlett-Packard Co. 

No. 1 Pennsylvania Plaza 
55th Floor 

34th Street & 8th Avenue 
MANHATTAN NY 10119 
Tel: (212) 971-0800 
CH,CS,E* ,M* 
Hewlett-Packard Co. 

250 Westchester Avenue 
WHITE PLAINS, NY 10604 
Tel: (914) 684-6100 
CM,CH,CS,E 
Hewlett-Packard Co. 

3 Crossways Park West 
WOODBURY, NY 11797 
Tel: (516) 921-0300 
A,CH,CM,CS,E,MS 


North Carolina 
Hewlett-Packard Co. 
5605 Roanne Way 

P.O. Box 26500 
GREENSBORO, NC 27420 
Tel: (919) 852-1800 
A,CH,CM,CS,E,MS 


Ohio 
Hewlett-Packard Co. 
9920 Carver Road 
CINCINNATI, OH 45242 
Tel: (513) 891-9870 
CH,CS,MS 
Hewlett-Packard Co. 
16500 Sprague Road 
CLEVELAND, OH 44130 
Tel: (216) 243-7300 
A,CH,CM,CS,E,MS 
Hewlett-Packard Co. 
962 Crupper Ave. 
COLUMBUS, OH 43229 
Tel: (614) 436-1041 
Eff: Nov. 25, 1983 
675 Brooksedge Blvd. 
WESTERVILLE, OH 43081 
CH,CM,CS,E* 
Hewlett-Packard Co. 
330 Progress Rd. 
DAYTON, OH 45449 
Tel: (513) 859-8202 
A,CH,CM,E*,MS 


Oklahoma 
Hewlett-Packard Co. 

304 N. Meridian, Suite A 
P.O. Box 75609 
OKLAHOMA CITY, OK 73147 
Tel: (405) 946-9499 

A* ,CH,E* MS 
Hewlett-Packard Co. 

3840 S. 103rd E. Avenue, #100 
P.O. Box 35747 

TULSA, OK 74153 

Tel: (918) 665-3300 

A** CH,CS,M* 


Oregon 
Hewlett-Packard Co. 
9255 S. W. Pioneer Court 
P.O. Box 328 
WILSONVILLE, OR 97070 
Tel: (503) 682-8000 
A,CH,CS,E* ,MS 


Pennsylvania 
Hewlett-Packard Co. 
111 Zeta Drive 
PITTSBURGH, PA 15238 
Tel: (412) 782-0400 
A,CH,CS,E,MP 
Hewlett-Packard Co. 
2750 Monroe Boulevard 
P.O. Box 713 

VALLEY FORGE, PA 19482 
Tel: (215) 666-9000 
A,CH,CM,E,M 


South Carolina 
Hewlett-Packard Co. 
Brookside Park, Suite 122 
1 Harbison Way 

P.O. Box 21708 
COLUMBIA, SC 29221 

Tel: (803) 732-0400 
CH,E,MS 

Hewlett-Packard Co. 
Koger Executive Center 
Chesterfield Bldg., Suite 124 
GREENVILLE, SC 29615 
Tel: (803) 297-4120 


Tennessee 
Hewlett-Packard Co. 

224 Peters Road, Suite 102 
P.0. Box 22490 
KNOXVILLE, TN 37922 

Tel: (615) 691-2371 
A*,CH,MS 


Hewlett-Packard Co. 
3070 Directors Row 
MEMPHIS, TN 38131 
Tel: (901) 346-8370 
A,CH,MS 


Texas 
Hewlett-Packard Co. 
4171 North Mesa 

Suite C-110 

EL PASO, TX 79902 

Tel: (915) 533-3555 
CH,E*,MS** 
Hewlett-Packard Co. 
10535 Harwin Drive 
P.O. Box 42816 
HOUSTON, TX 77042 
Tel: (713) 776-6400 
A,CH,CM,CS,E,MP 
Hewlett-Packard Co. 
930 E. Campbell Rd. 
P.O. Box 1270 
RICHARDSON, TX 75080 
Tel: (214) 231-6101 
A,CH,CM,CS,E,MP 
Hewlett-Packard Co. 
1020 Central Parkway South 
P.O. Box 32993 

SAN ANTONIO, TX 78216 
Tel: (512) 494-9336 
CH,CS,E,MS 


Utah 

Hewlett-Packard Co. 

3530 W. 2100 South 

SALT LAKE CITY, UT 84119 
Tel: (801) 974-1700 
A,CH,CS,E,MS 


Virginia 
Hewlett-Packard Co. 
4305 Cox Road 

GLEN ALLEN, VA 23060 
P.O. Box 9669 
RICHMOND, VA 23228 
Tel: (804) 747-7750 
A,CH,CS,E,MS 


Washington 
Hewlett-Packard Co. 
15815 S.E. 37th Street 
BELLEVUE, WA 98006 
Tel: (206) 643-4000 
A,CH,CM,CS,E,MP 
Hewlett-Packard Co. 
Suite A 

708 North Argonne Road 
SPOKANE, WA 99212 
Tel: (509) 922-7000 
CH,CS 


West Virginia 
Hewlett-Packard Co. 
4604 MacCorkle Ave. 
P.0. Box 4297 
CHARLESTON, WV 25304 
Tel: (304) 925-0492 
A,MS 


Wisconsin 
Hewlett-Packard Co. 

150 S. Sunny Slope Road 
BROOKFIELD, WI 53005 
Tel: (414) 784-8800 
A,CH,CS,E* MP 


URUGUAY 

Pablo Ferrando S.A.C. e |. 
Avenida Italia 2877 
Casilla de Correo 370 
MONTEVIDEO 

Tel: 80-2586 

Telex: Public Booth 901 
A,CM,E,M 


VENEZUELA 

Hewlett-Packard de Venezuela C.A. 
3RA Transversal Los Ruices Norte 
Edificio Segre 1,2 & 3 

Apartado 50933 

CARACAS 1071 

Tel: 239-4133 

Telex: 251046 HEWPACK 
A,CH,CS,E,MS,P 

Hewlett-Packard de Venezuela C.A. 
Calle-72-Entre 3H y 3Y, No. 3H-40 
Edificio Ada-Evelyn, Local B 
Apartado 2646 

4001, MARACAIBO, Estado Zulia 
Tel: (061) 80.304 

C,E* 

Hewlett-Packard de Venezuela C.A. 
Calle Vargas Rondon 

Edificio Seguros Carabobo, Piso 10 
VALENCIA 

Tel: (041) 51 385 

CH,CS,P 

Bioelectronica Medica C.A. 

Calle Buen Pastor 

Edif. Cota Mil-Piso 2 y Semi Sotano 1 
Boleita Norte 

Apartado 50710 CARACAS 1050A 
Tel: 239 84 41 

Telex: 26518 


ZIMBABWE 

Field Technical Sales 
45 Kelvin Road, North 
P.B. 3458 
SALISBURY 

Tel: 705 231 

Telex: 4-122 RH 
C,E,M,P 


July 1983 5952-6900 
Indicates main office 
HP distributors are printed in italics. 
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